Installing and Updating HP-UX 10.20, 
ACE and Hardware Extensions 

HP 9000 Computers 

B 2355-90173 



HEWLETT® 

PACKARD 


B 2355-90173 
April 1998 

©Copyright 1998 Hewlett-Packard Company 



Notices 


Use of this manual and compact disc(s), flexible disc(s) or tape 
cartridge(s) supplied for this pack is restricted to this product only. 
Additional copies of the programs can be made for security and back-up 
purposes only Resale of the programs in their present form or with 
alterations, is expressly prohibited. 

This document contains information which is protected by copyright. All 
rights are reserved. Reproduction, adaptation, or translation without 
prior written permission is prohibited, except as allowed under the 
copyright laws. 

Corporate Offices: 

Hewlett-Packard Co. 

3000 Hanover St. 

Palo Alto, CA 94304 

The information contained in thisdocument issubjectto change without 
notice. 

Hewlett-Packard makes no warranty of any kind with regard to this 
manual, including, but not limited to, theimplied warranties of 
merchantability and fitness for a particular purpose Hewlett-Packard 
shall not be liablefor errors contained herein or direct, indirect, special, 
incidental or consequential damages in connection with the furnishing, 
performance, or use of this material. 

A copy of the specific warranty terms appi icable to your H ewIett-Packard 
product and replacement parts can be obtained from your local Sales and 
Service Office. 

UNIX is a registered trademark in the United States and other 
countries, licensed exclusively through X/Open Company Limited. 

Copyright ©TheRegentsof the University of California 1979,1980, 
1983 

This software and documentation is based in part on the Fourth Berkeley 
Software Distribution under license from the Regents of the University 
of California. 

Copyright ©The Regents of the U ni versity of Colorado, a body corporate 
1979 

Copyright ©Veritas, I nc 1995. 


2 





This dcxument has been reprcxJuced and modified with the permission of 
the Regents of the U niversity of Colorado, a body corporate. 

Use, duplication or disclosure by the U.S. Government Department of 
Defense is subject to restrictions as set forth in paragraph (b)(3)(ii) of the 
Rights in Technical Data and Software clause in FAR 52.227-7013. 

Rights for non-DOD U.S. Government Departments and Agencies are as 
set forth in FAR 52.227-19(c)(l,2). 


Printing History 

April 1998 ... Edition 1 . 

This edition documents material related to installing and upgrading 
FIP-UX operating systems and application software. Some of this 
material was previously included in I nstalling FIP-UX 10.20 and 
Updating from HP-UX lO.Oxto 10.20 (HP Part No. B2355-90119). 

The printing date and part number indicate the current edition. The 
printing date changes when a new edition is printed. (M inor corrections 
and updates which are incorporated at reprint do not cause the date to 
change.) The part number changes when extensive technical changes are 
incorporated. 

New editions of this manual will incorporate all material updated since 
the previous edition. 

HP Division: 

HP-UX Learning Products 
Hewlett-Packard Company 
3404 E ast H armony Road 
Fort Collins, CO 80528-9599 


3 





Customer Comments 

Please direct comments on documentation or software to the foil owing: 

user I i n k(gfc h p.com 

Fax: (970) 898-4720 

Hewlett-Packard Company 

WSY Information Engineering Group 

Mai I stop #27 

3404 East Harmony Road 

Fort Col I i ns, CO 80528-9599 


4 





Contents 


1. Before You Install 

Planning Your New I nstallation.10 

Media for the Release.10 

I nstallation Tasks.10 

What is a Cold I nstall?.11 

Supported Hardware.15 

Hardware-Specific OS Enhancements.16 

System Requirements.17 

Hardware Requirements.17 

Networking Requirements.19 

Checking the Media.20 

Using Software Bundles.20 

Obtaining and Entering Codewords.21 

Backing Up Your Current System.22 

Choosing the I nstall Source.24 

Setting Up the Network I nstall Source.24 

2. Installing HP-UX 

Booting from Media (All Series).28 

Workstation (Series 700) Boot Process.29 

Server (Series 800) Boot Process.31 

After Selecting Boot Paths (Workstations and Servers).34 

Booting from a Network (Workstation/Series 700, B, C J Only).35 

Older Series 700.35 

Newer Workstations (Series 700, B, C, J ).36 

System Configuration.38 

Installing and Configuring the Operating System.39 

Configuring for Network Installation.39 


5 




























Contents 


Selecting the R(X)t Disk.42 

Viewing or Modifying Configuration.44 

Configuring the Disk and File System.48 

Loadi ng the Core Operati ng System.54 

Specifying System I nformation.55 

Verifying and Completing the I nstallation.58 

Listing I nstalled Applications.58 

Removing Unwanted Software/Filesets.59 

Creating a Recovery System.59 

I nstal ling Extension Software.60 

I nstal ling Applications Software.60 

3. Updating HP-UX 

FIP-UX 10.20 System Requirements.62 

Starting the Source Media.63 

U pdati ng SD-U X Before I nstal I i ng/U pdati ng Software.65 

SW-DIST Installation.66 

U pdati ng SD-U X Without Root Access to the Remote Depot.66 

Updating FIP-UX Software.69 

Updating a Single System or Series 800 Server-Cluster.69 

Updating a Cluster.69 

Updating Non-I nteractively from Media or Network.77 

Using FIP-UX Extension Software.77 

Adding Additional Functionality.79 

Networking Products on Additional Media.79 

Installing the Optional Online] FS Product.80 

4. Troubleshooting Your Installation 

Network I nstal I .82 


6 





























Contents 


Media I nstall.83 

Adjusting File System Size.83 

Large System.86 

A. Sample Configuration File 

B. Configuring for a DHCP Server 

Using DHCP Services: Overview.94 

Setting Up a DHCP Server.95 


7 








Contents 


8 




Before You Install 


This manual covers HP-UX 10.20, Additional Core Enhancements (ACE) 
and Hardware Extensions "cold" installations and updates, as well as 
updates from 10.x to 10.20. 

• Coldinstall means installing system software on a new (uninstalled) 
or existing system disk in such a way as to completely erase old data. 
See Chapter 2, "I nstalling HP-UX," for the cold install procedure for 
HP-UX 10.20. 

• Update, for HP-UX 10.x, means using the SD-UX tools to install new 
OS or application softwarefrom a media or network source depot. See 
Chapter 3, "Updating HP-UX," for the procedure for updating 10.x to 
10.20. Use the tool swiist with your install depot to obtain current 
information on bundle and product contents. 

• Upgrade means using the 9.U3 tools and procedures to update your 
system from a pre-10.0 version of H P-UX to 10.01. The SD-UX tools 
are then used to update from 10.01 to 10.10 or 10.20.1 nformation 
about utilities and procedures for upgrading your system from 
HP-UX 9. Ox systems is covered in the manual Upgrading from 

H P-UX 9.x to 10.x and in the Release Notes for this software (online in 

/us r/share/doc). 


Chapter 1 


9 



Workstations: 


Servers: 
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Planning Your New Installation 


Planning Your New Installation 

New features, component software, and recent changes for your new 
system are described in the Release Notes for your new system, located in 

/usr/share/doc. 

Media for the Release 

The following CDs are supplied with typical Media Kits, for 
Workstations or for Servers, as indicated: 

• Install and Core OS Software: Additional Core Enhancements (ACE 
2.0). Use this CD to install theACE software(Workstations). 

• Install and Core OS Software. This is the base OS release only. 

• HP-UX Recovery Media 

• 10.x Extension Software 

• HP-UX Application Software (5 CDs) 

• H P-UX Diagnostic/I PR Media 

• I nterworks Contributed Software (2 CDs) 

• 10.20 Hardware Extensions 2.0 

• H P-UX I nstall and Core OS. This is the base OS release only. 

• HP-UX Recovery Media. 

• 10.x Extension Software. 

• HP-UX Application Software (5 CDs). 

• H P-UX Diagnostic/I PR Media. 

Installation Tasks 

During the H P-UX 10.20 installation process, you will need to do the 
following: 

• Connect and test devices. 

• Boot a minimal operating system from media (or a network). 
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• I nstall software products from tape, CD-ROM, or network. 

• Execute HP-UX commands. 

Some of these tasks may require previous experience or the availability 
of a system administrator. 

Before you begin the install process, you should be prepared to enter 
some information as part of the process (especially if you are installing 
any part of the OS and applications from a network source). The process 
may ask for such information as the following: 

• The hostname of the (new) system on which you are installing 
HP-UX. 

• The local host's I nternet Protocol (I P) address. 

• Default routing I nternet Protocol (I P) address. 

• The subnet mask (for example, 255 . 255 .248. o or Oxf f f f f 800 ). 

• The IP address of an install server (if used). 

If you have a DHCP server available, the network information can be 
provided automatically. See Appendix B, "Configuring for a DHCP 
Server." 

After you have installed the 10.20 operating system, you will use other 
HP-UX tools, utilities and scripts to set up windowing, networking, 
printing, mail, etc. This document does not cover these post-installation 
activities. For further information on these tasks, seethe manual System 
Administration Tasks (HP Part No. B2355-90079). 

What is a Cold I nstall? 

A cold install is performed when your new system does not come with a 
pre-loaded operating system, or when a system is corrupted and you 
want to start over with a new H P-UX 10.x system. 

If you purchased your system with the HP-UX Instant Ignition option, a 
vasion of H P-UX has already been installed, according to the 
specification in your order. You do not need to reinstall it unless you want 
to make changes in the disk layout. 
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Planning Your New Installation 

The Installation Process 

This HP-UX installation procedure is similar tothat used for previous 
versions of H P-UX 10.x. During the cold install process, an install kernel 
is booted from the HP-UX I nstall Media (see below) or from a server on 
the network (Workstation (Series 700) only). Your system disk is then 
initialized and the new system configured using a set of default 
configurations supplied on the I nstall Media. You can either use one of 
these default configurations or create your own custom configuration. 
Once the configuration and initialization is complete, a new 
full-functioned HP-UX operating system and applications are loaded 
from the H P-UX 10.20 media (or from the network) onto your system 
disk. 


CAUTION A cold install will erase all existing data on the target disk(s) during the 

process. 


The HP-UX 10.20cold install process is similar for all current HP 9000 
computer platforms. See the flow chart Figure 1-1 which outlines the 
process. 
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Figure 1-1 


The Cold Install Process 



Each of thesteps in thediagram isexplained in Chapta 2. 
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Planning Your New Installation 


NOTE 


The HP-UX 10.20 Install Media 

The I nstall program software is a single, self-contained volume on 
CD-ROM (combined with the HP-UX core) which contains the foil owing 
Install items: 


Lit File 

ISL 

HPUX 

AUTO 

CONFIG 

INSTALL 

INSTALLFS 

INSTCMDS 

SYSCMDS 


Purpose 

The initial system loader. 

A secondary loader. 

The auto-boot file. 

The file that describes the default system 
configurations which you can specify. 

The install kernel. 

Install RAM File System. 

A compressed tar-archive cental ni ng the commands 
used during the InstalI process In the RAM-FS. 

A compressed tar-archive containing the mini-system 
that is extracted prior to running the SD-UX software 
management commands. 


Seethe Release Notes on your system (/usr/share/doc) for the list of 
other patches and components on your install and Core CD 


There are separate CD-ROMs for HP Workstation (Series 700) and 
Server (Series 800) hardware. For both, the delivery medium is 
CD-ROM, except for certain custom deliveries. 


On H P 9000 Workstations (Series 700), the I nstall Kernel can also be 
loaded from a network source. See the section "Booting from a Network 
(Workstation/Series 700, B, C J Only)", in Chapter 2, "I nstal ling 
HP-UX,"for more information on network installations. 


The ability to load the 10.20 install kernel from a network source is not 
availableon H P Server (Series 800) computers. For these computers, you 
must load the install kernel from the physical media. You can, however, 
then install Server OS and application products from a network SD-UX 
server, once the install kernel has been loaded from local media. 
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Workstations 


The HP-UX Product Media 

Theprcoduct media for the "I nstall and Core" HP-UX product consists of a 
CD-ROM containing both the I nstall program and the Core HP-UX 
product. The CD contain all the bundles, products and fiIesets, both 
required and optional, for a fully functional system. See "Using Software 
Bundles"in this chapter for more information on thissoftware. If you are 
using optional networking products on additional media, please see also 
"Networking Products on Additional Media", in Chapter 3, "Updating 
HP-UX,"in this manual. 

A display listing of 10.20 bundles, products, and contents can be obtained 
by running swiist on your source depot (disk, CD-ROM, tape, or 
network). See Chapter 3, "Updating HP-UX," for instructions on using 
swgettoois to update the SD-UX tooisfirst, if the source is a new 
version of H P-UX. 

Supported Hardware 

The following new workstation hardware is supported on this release, at 
the time of printing. (See your HP representative for updated 
information): 

Model CPU Speed(MHz) 


C200 PA-8200 200 

C240 PA-8200 236 

B132L-P PA-7300LC 132 

B180 PA-7300LC 180 

J 2240 PA-8200 236 


The following are supported for NFS diskless client-server 
configurations: 

Models 705, 710, 712, 715, 720, 725, 730, 735, 742, 743, 745, 747, 
748, 750, 755, B-class, C-classandJ -class 
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Servers Server systems supported on this release include the following: T600, 

K370, K570, K380, and K580. See your HP representative for updated 
support information. 

Hardware-Specific OS Enhancements 

The J2240 Software This J 2240 Software and other enablement software on your I nstall and 
Core disc contain special versions of the HP-UX install and core os 
for use with the new J 2240 PA-RI SC workstation and other systems 

TheJ 2240 software includes two Additional Core Enhancement (ACE) 
bundles for H P-UX. TheJ uly 1997 Workstation ACE bundle adds 
support to HP-UX for the PA-RI SC 8200 processor, Ultra SCSI I/O, 100 
BaseT networking, VISUALIZE-FX graphics, andtheOpenGL 3-D 
programming API. The current (April 1998) ACE adds multiprocessor 
(M P) configuration support for thej 2240. 

The I nstall and Core OS CD-ROM contains all software necessary to boot 
and run aj 2240 workstation: 


CAUTION Do not remove either of the Workstation ACE bundles from a J 2240 

computer. This software is necessary to boot and run the] 2240. 


Before You Install a For information on upgrading your J 282 system, see the instructions in 
J2240 M odel J 2240 U pgrade (P/N A2876-90012). 

For detailed installation information, usethis manual. 

For information on known problems, refer to the "Known Problems" 
section of the current ReleaseNotes (onlineon your new system, in 
/usr/share/doc/ or availableon the HP Software Depot web site: 

WWW.software.hp.com. 
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System R equ i rements 

Besides the mini mums shown below, you will have additional 
requirements for such things as swap space, tools, utilities, facilities, 
environments, applications, languages, user files, data, graphics, 
printing and plotting. Refer to the System Administration Tasks manual 
for information on these topics. 

Hardware Requirements 

To install this OS software, you must have the foil owing: 


Computer An H P 9000 Series 700 or 800 computer. Series 700 
also includes Models B, C andj. Series 800 also 
includes Models A, K, E, F, G, H, I, D, T, and 
"Ultralight". 

Memory The minimum RAM for H P-UX 10.20 is 16 M B. (For 

some older Series 800 models, such as 8x5 which 
support 8MB cards in the first slot, the RAM 
requirement for system loading must be configured as 
at least 16 M B in thefirst slot.) Your FI P representative 
can assist in obtaining the proper amount of RAM. 

I nformation on RAM requirements is also on the 
following web site: 

http://www.hp.com: 80 /computing/mvp/memory. 
html. 


Source Device Make sure that your system has an appropriate source 
(CD-ROM, DDS drive, or network (S700, B, C, or J )). 
For tape drives, be sure the heads are clean. 

Disk Drive At least one hard-disk drive with at least the following 
capacities: (The install program performs an analysis 
of disk space needed prior to loading the software.) 


• 525 MB for a minimum standalone workstation. 

• 1GB or more for a generally usable system. 
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File System Types 


Disk Layouts 


Other Devices Your system can also have any H P-supported device. I f 
you have an unsupported device connected to your 
system, HP assumes no responsibility in making that 
device function properly. 

Supported Peripherals 

With the disk space provision above, al I disk drives that are supported as 
HP Workstation and Server system disks are supported for installation. 

Disk arrays can be installed with HP-UX, but the installation tasks do 
not support configuring an array. See your array documentation for 
configuration information. 

The H P-UX installation tools support VTIOO and Wyse 60 terminals, 
compatible emulations, and all HP terminals. 

Supported File System Types and Layouts 

The HP-UX 10.20 filesystem layout is quite different from HP-UX 9.0x 
releases. The 10.20 file system is modeled after the UNIX™ SVR4 and 
OSF/1 systems. This layout provides such benefits as the separation of 
OS software from application software, and it also resembles the UNIX 
standard layout used by many other computer companies. 

HP-UX 10.20 supports thefolIowing filesystem types: 

• UFS/HFS or VxFS (J ournaled File System) on local disk volumes. 

• NFS. 

The file system for a cold-installed H P-UX will be supported on the 
following disk layouts: 

• "Wholedisk" (singlefile system, single swap partition disk layouts as 
on H P-UX 9.0 for Series 700). 

• The Logical Volume Manager (LVM). 

The Logical Volume Manager is offered on both the Series 700 and Series 
800 platforms. Becauseit helps to organize filespace across multiple 
physical disks, you are encouraged to adopt this method of disk 
management. Seethe manual System Administration Tasks, or the 
lvm(7) man page for details. 
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For H P-UX 10.20, Series 700 Software Disk Striping arrays are not 
supported. SDS arrays can be converted to LVM via the utility 
sdstoivm. If you upgrade to HP-UX 10.20, as opposed to installing it, 
this conversion will be done for you automatically during the upgrade. 

LVM disk striping can beset upon some volumes during theinstallation. 
However, striped volumes cannot be mirrored later on. Note that not all 
types of volumes may striped. This is due to an unbalanced amount of 
disk space assigned to the root/boot/swap volumes on the root disk that 
must not be striped. 

Networking Requirements 

Networking capabilities are not mandatory for a 10.20 cold install unless 
you are loading your OS and applications from a remote system. If you 
are loading from a remote system, you will need the following (for the 
Ethernet™ interface): 

• A network card. If your system has multiple LAN cards, select the 
card that is configured onto the correct network during the install 
process. Only one card can be configured for install. All other cards 
will not be configured and cannot be used during the installation. 

• A network install server. This must be on the same network subnet as 
the system that will be booted. This may require having one server on 
each subnet from which to boot clients. 

• A functional network connection. If you have more than one LAN 
connection, be prepared to select the correct one with which to 
connect to the install server system. 

Note You cannot cold install via the network from a non-Ethernet 
i nterface 
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Checking the Media 

Make sure you have obtained the HP-UX tape or CD-ROM that matches 
your source device type. Note that applications requiring codewords will 
be on a separate CD. If your HP-UX product has multiple licenses, the 
installation process will install the most restrictive license unless you 
load a higher level license from the applications CD-ROM. 

Using Software Bundles 

The software "bundle" is a collection of filesets that have been 
encapsulated by H P for a specific purpose. These bundles make it easier 
to load several filesets onto your system as a single entity using the new 
SD-UX Software Distribution Commands (swinstaii, swcopy, 
swremove, etc). Bundles can be kept in SD-UX depots and copied, 
installed, removed, listed, configured and verified. All H P-UX 10.20 OS 
software is packaged in bundles to make it easier to install. See 
Managing HP-UX Software with SD-UX (H P Part Number B2355-90080) 
for more information on SD-UX commands, bundles and depots. 

A bundle is used in the same way as the pre-10.20 "partition", except 
that a bundle can contain filesets from several different products. I n 
general, performing a single operation on a bundle is the same as 
performing it individually on all the filesets listed in the bundle. 

Bundles do not eliminate your ability to choose which initial products 
and filesets you wish to load on your system. You may still do this by 
i nteracti ng with the swinstai i uti I ity (see "Loadi ng the Core Operati ng 
System", in Chapter 2, "I nstalling H P-UX.") 
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Obtaining and Entering Codewords 

There are two types of software on the Product Media: protected and 
unprotected. The core H P-UX software is not protected and has no 
codeword. To access any protected software on a CD-ROM, you must 
enter an authorized codeword in the SD interface. To access unprotected 
software, no codeword is required (for example, the HP-UX 10.20 
Runtime bundle does not require a codeword). 

You will haveaccessonly to those items on the CD-ROM medium that 
you have purchased, which are unprotected, or for which you have the 
proper codeword. Your codeword appears on the document Codeword for 
I nstalling Softwarethat comes with your software; it is associated with 
your customer ID. If you received a document Codeword for I nstalling 
Software— Submittal Certificate along with a Codeword Request Form, 
you can obtain a codeword and Customer ID by returning the latter form 
to the HP License Administration. 

Product Examine all the packages that contain your products and the Software 

Documentation Certificate(s). Keep the certificates handy. I f your certificate does not 

include a codeword (and you want to load optional, protected software) 
you must obtain a codeword from Hewlett-Packard by following the 
codeword instructions that come with your Software Certificate. If you 
have problems with the codeword process, contact H P License 
Administration. 
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Backing Up Your Current System 

• If you currently have no operating system or files on your system or if 
you have an OS and software that you can safely destroy, there is no 
need to perform a backup. You can now proceed with the installation 
and later set up a backup procedure. 

• If you already have an operating system and files on the system disk, 
you should make a full backup of the system before you start the 
install. 

If your system is running a 9.0x version of H P-UX, you may want to 
upgradeto H P-UX 10.20 (via 10.01), not install it. Seethe manual 
Upgrading from HP-UX 9.xto 10.xfor detailed procedures for 
performing an upgrade. 

• You must be running 9.0 or later to upgradeto 10.20. 

• If you have a system running a pre-9. Ox version of HP-UX, and you 
are willing to destroy all system customization in order to install 
10 .20, then cold-installing 10.20 may be the right answer. 

Remember that HP-UX 10.20 uses pathnames and file locations that 
are different from H P-UX 9.0x. Back up your current system, if any, 
in such a way as to separate "structural" (system) directories from 
"data" (user and application) directories. This will allow you to 
recover data directories onto 10.20 without compromising the 10.20 
structure. 

You should not recover any pre-10.0 "structural" files onto the 10.20 
system. Recover them only if the 10.20 install faiisfor some reason and 
you need to restore the pre-10.0 version of H P-UX. 

For additional backup security for cold install, you can optionally do the 
following: 

• Make printouts of customized files and refer tothem after the 
installation (for example, files such as .profile, /etc/netiinkrc, 
/etc/passwd). 

• Collect customized files in a directory (for example, /old). Use 
tar (1) to make a tape archive of the files in /old. After the 
installation, restore the files, editing them as desired. 
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You should also make copies of your "dot" files (for example, .profile 
and .maiirc). For further information about these files, seethe manual. 
System Administration Tasks. 
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Choosing the Install Source 

An HP-UX 10.20 cold install can be made from two different sources. 

• Physical media (CD-ROM). See "Booting from Media (All Series)", in 
Chapter 2, "I nstalling H P-UX." 

• Network source. See the next section, "Setting Up the Network 
Install Source". 

You can also choose to load only the I nstall Kernel from the installation 
media and then load the Core OS bundles and products from a network 
source. This would be especially useful for a Series 800 system, which 
does not support booting over a network at this time. 

Setting Up the Network I nstall Source 

A "network cold install" uses another machine on the network as its 
installation source. Once this isset up, a network install isthe fastest 
installation method. Complete network cold installscan bepaformed on 
a Series 700 system only, but you can use either a Series 700 or Series 
800 as the install server. After an install server is set up on your 
network, you can boot new systems from the server, and once booted, the 
installation process is similar to I nstalling from physical media. 

Requirements for a network install server are: 

1. HP-UX 10.20 on the server system. See "H ardware Requi rements", i n 
this chapter. 

2. Your server must be on the same network subnet as the system that 
will be booted. This may require having one server on each subnet 
from which to boot clients. 

3. You must have the HPUX-instaii product or Netinstall bundle 
loaded on the server. If Hpux-instaii is not installed on your server, 
you must load it from the 10.20 Cor e-OS media using the swinstaii 
command. You can obtain the Hpux-instaii product by loading the 
entire Netinstall bundle from the Core-OS media. 

4. You will need about 21 MB of free space in the server /usr/iib 
directory to accommodate hpux-install. 
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5. You must edit the file /etc/insti_boottab on the server and add 
at least one IP address that is reserved for booting install dients. The 
IP addresses you add should be for cold installs only and should not 
be used by any other systems. However, if you know the LAN Link 
Addresses (L L A) of the systems you wi 11 be i nstal I i ng, you can use the 
IP addresses of those systems, providing you append the keyword 
"reserve". See the examples in the file /etc/insti_boottab for 
more guidance. 

6 . If you want to boot multi pie systems from the server at the same 
time, you must add more than one IP address to this file. The server 
may deny boot services if multiple systems try to use the same IP 
address during booting. 

Optional Install Server Configuration Steps 

After your install server is set up, you may want to create some default 
parameters to makethe process easier. Running the insti_adm 
command on the server can do this. 

For example: 

Use insti_adm (iM) toset the default SD-UX server and depot as in the 
following command line (where sd_serva is replaced by the hostname of 
theswinstall server, and /var/hpux_depot is the location of its software 
depot): 

insti_adm -s sd_server :/var /hpux_depot 

You can also create a message that can be displayed to users during the 
installation. 

For example: 

The i nsti_adnn —a option can be given a filename that contains the 

message or, if given a " (dash) as shown below, the command will 
prompt you to type in the message foil owed by ctri-D "end-of-file". Adding 
the -d option will cause the command to display the default information 
after making the changes, as follows: 

instl_adm -a - -d 

The insti_adm (iM) Utility can also allow the advanced user toset up 
enough information tocompletely automate the installation. This is done 
by specifying configuration information as listed in the instl_adm(4) man 
page. 
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Before You Install 

Choosing the Install Source 

For More I nformation 

For examples of install configuration files, see Appendix A, "Sample 
Configuration File,", in this manual. 

For general information, see the online information on the install 
program in /usr/share/doc/lO . 2 0ReiNotes. For more details on 
setting up a network server, see the comments in the 
/etc/insti_boottab file, and the instl_bootd(lM) man page 

If you have problems in booting systems, look in the file 
/var/adm/sysiog/sysiog. log for error messages which will tell you 
whether more IP addresses are needed. 

For more details on depots and the swinstaii command, seethe 
manual Managing FIP-UX Softwarewith SD-UX. 


Information on HP 
Software Deport 


Seethe FI P I nformation website, www.hp.com (Business and Technical 
Computing: Documentation) for additional FI P-UX documentation. 
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Installing HP-UX 


I n this chapter you will find start-up procedures based on the use of two 
types of sources: 

• Booting from media. 

• Booting from a network (Series 700, B, C and J classonly). 

If you have any problems, see Chapter 4, 'Troubleshooting Your 
I nstallation,". 
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CD-ROMs Used in 
Installation: 


Procedure 


Installing HP-UX 

Booting from Media (All Series) 


Booting from Media (Ali Series) 

OnlythG Install and CORE OS Software: Additional Core 
Enhancements or Hardware Extensions CD wl 11 bG nGSded for thG 
OS installation. OthGT CDs (or custom tapGs) will contain thG foil owing 
for softwarGupdatGor backup purposes: 

• CD-ROM: HP-UX 10.20 Install and CORE. This Is the basG 
release media. Do not install this CD for recent hardware requiring 
ACE (Workstation) or Hardware Extensions (Server) 

• CD-ROM: HP-UX Application Software. (5 CDs) 

• CD-ROM: HP-UX Recovery Media. 

• CD-ROM : Diagnostic/IPR Media. 

• CD-ROM: HP-UX Extension Software (I ncludes essential 
patches). 

• CD-ROM: Interworks Contributed Software (2 CDs). 

1. Check with your system administrator, if necessary, about the 
hardware path and identity of your boot CD-ROM. 

2. M ake sure any external boot device connected to the system to be 
booted is turned on. 

3. Turn on the computer or cycle power. 

4. P ress esc to stop the boot process. 

5. I nsert the install media into the appropriate drive. 

• Workstations: At the message that says how to stop autoboot, 
press and hold esc. 

• Servers: At the message that says how to stop autoboot, press and 
hold any key. 

You will seethe boot console menu. As boot procedures vary 
somewhat, depending on your hardware, the following pages give you 
detailed guidance on various types of systems. 
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Booting from Media (Aii Series) 


After it does a search, the boot ROM lists the devices from which you can 
boot. If a desired local boot device is not listed, and you have connected 
and powered it, check the cable connections before proceeding. LAN 
sources may require several searches. 

I n both the Server and Workstation boot console, there is an on-line help 
facility to guide you through the process. If you need help, type help 
boot. 

Workstation (Series 700 ) Boot Process 

If you stop the boot process, the system will display a menu of boot 
commands. For some systems, you will see a help display similar to the 
following: 

For different computers, depending on your hardware type, you may see 
slightly different screens in the autoboot process. 


Newer Series 700 Boot 
Help Menu; 

Figure 2-1 


Description 


Command 

Auto [boot I search] [on[off] 

Boot [priI alt Iscsi.addr] [isl] 

Boot Ian[.lan_addr] [install] [isl] 
Chassis [on|off] 

Diagnostic [on|off] 

Fastboot [on I off] 

Help 

Information 
LanAddress 
Monitor [type] 

Path [prilalt] [ Ian.id|SCSI.addr] 
Pirn [hpmcI toe IIpmc] 

Search [ipl] [scsi|Ian [install]] 
Secure [on|off] 


Display or set auto flag 

Boot from primary, alternate or SCSI 

Boot from LAN 

Enable chassis codes 

Enable/disable diagnostic boot mode 

Display or set fast boot flag 

Display the command menu 

Display system information 

Display LAN station addresses 

Select monitor type 

Change boot path 

Display PIM info 

Display potential boot devices 

Display or set security mode 


When you see this screen, do the foil owing: 

1. Type search Enter. 

2. If your CD-ROM device is identified in the list shown by the search 
command, proceed with the following steps. Otherwise, check the 
device and cable connections and repeat the search. 
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Installing HP-UX 

Booting from Media (Aii Series) 


3. Type the foil owing: 

boot scsi.X 

Use the SCSI address of the boot device for x. 

4. If you see the foil owing prompt, respond with "n". 

Interact with IPL (y or n)? 


Older Workstation Older Series 700 systems display a menu similar to the following: 
Boot Menu: 

Figure 2-2 

b) Boot from specified device 

s) Search for bootable devices 

a) Enter Boot Administration mode 

x) Exit and continue boot sequence 

?) Help 

Select from menu: 

When the actions menu shown above appears, do the foil owing: 

• Press s Enter, to Start a search for bootable devices. 

Older Workstation 
Search Results 

Figure 2-3 


Searching for Devices 

with 

Bootable 

Media. 


To terminate search. 

press 

and hold 

the ESCAPE 

key. 

Device Selection 

Device Path 


Device Type and Utilities 


PO 

scsi.6.0 

HP 

IPL 

2213A 

PI 

scsi.3.0 

HP 

IPL 

HP35480A 

P2 

scsi.0.0 

TOSHIBA 

IPL 

CD-ROM XM-3301TA 

Enter boot selection. 

(h)elp, or e(x)it: 





You will see a list of "pn" selections, as above. 

If the desired device does not appear in the search list, do the following: 
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Booting from Media (Aii Series) 


1. Check the hardware. 

2. Press X Enter. 

3. Types Enter to initiate another search. 

4. At the prompt "Enter boot selection", enter the "pn" device 
selection for the device containing your install media. 

I f you know the SCSI address of the boot device beforehand, you can ski p 
the search and simply type the following at the "Select from menu" 
prompt: 

b scsi.X 

Time Note After you have selected your boot device, loading the install kernel on a 

Workstation should take 3 to 5 minutes. After this you will be ready to 
interact with the rest of the H P-UX I nstall Utility to load the remainder 
of your system. 

Server (Series 8(X)) Boot Process 

As noted previously, you can halt the autoboot process and use the 
autoboot commands. To do so, press any key during the autoboot process 
to display a Main Menu similar to the following: 


Newer Series 800 Boot 
Menu 

Figure 2-4 


- Main Menu 

Command Description 

BOot [PRII ALT I<path>] 

PAth [PRIIALT] [<path>] 

SEArch [Display IIPL] [<path>] 
configuration menu 
INformation menu 
SERvice menu 
Display 

HElp [ <menu>I<command>] 

RESET 

Main Menu: Enter command or menu > 

The capital letters in each command represent the minimum characters 
(mnemonics) you need to type in order to launch that command. 


Boot from specified path 
Display or modify a path 
Search for boot devices 
Displays or sets boot values 
Displays hardware information 
Displays service commands 
Redisplay the current menu 
Display help for menu or command 
Restart the system 
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1. When you have chosen your boot device and entered the boot 
command, a connection will be established with the boot device. It is 
common that the Alternate Boot Device is set to an external 
CD-ROM. If this isyour case, you can simply use the foil owing 
command: 

bo alt 

2. If you want to search for available boot devices, type: search (or the 
appropriate abbreviated command, as shown). 

A typical output might look I ike the foil owing 


Newer Server Search 
Results 

Figure 2-5 


Searching for potential boot device. 
This may take several minutes. 

To discontinue, press any key. 


Path Number 

Device 

Path 

Device Type 

PO 

56/52.0 

(dec) 

Seq. record access media 

PI 

56/52.3 

(dec) 

Seq. record access media 

P2 

56/52.4 

(dec) 

Random access media 

P3 

56/52.6 

(dec) 

Random access media 


Main Menu: Enter command or menu > 


For example, type "bo pn" where "pn" is the path number shown in the 
search output. You can also specify the device by the hardware path, 
such as "5 6/52.0", in place of the path number. 
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Booting from Media (Aii Series) 


Oider Server Boot For Models 8x7, 845, 835, 870, and other older Series 800 computers, you 
Process will see a boot display I ike the foil owing: 

Figure 2-6 


Console path 

= 56.0.0.0.0.0.0 

(dec) 


38.0.0.0.0.0.0 

(hex) 

Primary boot path 

= 52.2.0.0.0.0.0 

(dec) 


34.00000002.0.0, 

,0.0.0 (hex) 

Alternate boot path 

= 52.0.0.0.0.0.0 

(dec) 


34.0.0.0.0.0.0 

(hex) 


64 MB of memory configured and tested. 

Autoboot from primary path enabled. 

To override, press any key within 10 seconds. 


Boot from primary boot path (Y or N)?> n 
Boot from alternate boot path (Y or N)?> 
Enter boot path, command, or ?> 


1. Turn on the system. 

2. Press any key to stop the autoboot process, at the message to do so. 

3. I nsert the install CD-ROM. 

4. Determine the hardware path of the install device from your system 
administrator. (There is no search capability to determine this 
information on older Series 800 models). 

• If the primary path shown on your screen is not the same as that 
for the install device, respond with "n" to the prompt "Boot from 
primary boot path". I n this case, you will then be asked if you 
want to boot from the alternate path, which is typically set to an 
external CD-ROM device. 

• I f the pri mary path shown on your screen matches that for the 
install device, respond with "y". 
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Installing HP-UX 

Booting from Media (Aii Series) 


• I f neither the pri mary or alternate device paths correspond to that 
for the CD-ROM device, then respond with "n" to both prompts. I n 
this case, enter the hardware path of the device (for example, 

52.3 . O) at the prompt "Enter boot path, command, or ?>". 

5. To the question "Interact with IPL (y or n) ?", respond with 

II II 

n . 

After Selecting Boot Paths (Workstations and 
Servers) 

1. If you see the following question on your screen, typen: 

Interact with IPL (Y or N)?> n 

2. You can abort the installation at this point, if you wish, by turning 
the system off and starting over. 

3. When you have chosen the boot path and loaded the I nstall Kernel, 
the system will display the H P-UX I nstallation Welcome screen. 
From this point on, you will respond to the requests for information 
on these screens. 

Loading the I nstall Kernel should take 3 to 5 minutes. 

For the remainder of the installation, goto "I nstalling and Configuring 
the Operating System", in this chapter. 
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Figure 2-7 


To Search for Servers: 


Installing HP-UX 

Booting from a Network (Workstation/Series 700, B, C J Only) 


Booting from a Network 
(WDrkstation/Series 700, B, C J Only) 

1. Determine your network server address for the i nstalI. I f necessary, 
see your system administrator for this information. 

2. Turn on your Workstation. 

3. When you see a message about stopping the boot search, quickly 
press and hold esc to stop the boot selection process. 

Older Series 700 

On older Series 700 machines, you will eventually see the foil owing: (For 
newer Workstations, see the section "Newer Workstations (Series 700, B, 
C, J )", in this chapter.) 


b) Boot from specified device 

s) Search for bootable devices 

a) Enter Boot Administration mode 

x) Exit and continue boot sequence 

?) HelpSelect from menu: 

Do one of the fol lowi ng: 

• If your network has only one install server and your system is not 
configured as a diskless client, then type: 

boot Ian 

The boot may fail thefirsttimebecauseof an intentional delayed 
response by the i nstal I saver. If it fails, try it again. If it fails more 
than three times, check for problems on the install server (see 
Chapter 4, 'Troubleshooting Your I nstallation,"). OR 

• If your network has multiple install servers, make sure you boot from 
the network serva address specified by your system administrator. 

1. Type the fol I owing: 

search Ian Enter 

2. I f your server does not appear duri ng the search, type "x" i n order to 
exit and continue the boot sequence. 


Chapter 2 


35 





Installing HP-UX 

Booting from a Network (Workstation/Series 700, B, C J Only) 


• If necessary, type the foil owing command again: 

search Ian 

Note that it will typically take two or three searches bd'orethe 
install server will befound, duetoa built-in delayed response from 
the install server. 

• Identify your LAN server from the listing. 

• I f three attempts result I n no response from the desi red server, see 
Chapter 4, 'Troubleshooting Your Installation." 

3. If you know the Ethernet™ address of your server and can specify 
where to boot without going through the search process, type: 

boot ian.080009-nnnnnn 

where 080009-nnnnnn is the Ethernet address of the install server. 
This number can befound by running the lanscan(lM) command on 
the server. 

• If your server is listed during the search, then you can boot the 
system by typing "p" and the index number of the server. For 
example: 

pi 

This will cause the boot to begin. OR 

• Alternatively, you can exit this screen by typing "x Enter", and typing 
"boot pi" at the previous screen. 

Newer Workstations (Series 700 , B, C J ) 

On newer Workstations, after the power is turned on, you will see a 
graphical interface screen that displays instructions to press esc to stop 
the boot process. 

1. Press ESC, and you should see the foil owing menu: 


Figure 2-8 
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Booting from a Network (Workstation/Series 700, B, C J Only) 


Command 

Auto [boot I search] [on[off] 

Boot [priI alt Iscsi.addr] [isl] 

Boot Ian[.lan_addr] [install] [isl] 

Chassis [on|off] 

Diagnostic [on|off] 

Fastboot [on I off] 

Help 

Information 
LanAddress 
Monitor [type] 

Path [prilalt] [ Ian.id|SCSI.addr] 

Pirn [hpmcI toe IIpmc] 

Search [ipl] [scsi|Ian [install]] 

Secure [on|off] 

BOOT_ADMIN> 

• If your network only has one install server available, type the 
following: 

boot Ian install 

• Otherwise, to make sure you boot from the correct server, do one of 
the foil owing: 

• M ake the system search for servers and pick one. OR 

• Explicitly tell the system whereto boot, as follows: 

a. To search for servers type the following: 

search Ian install 

b. The list of servers will be displayed with IP addresses. You may 
need to run the command nsiookup on another runni ng system to 
determine which address corresponds to your server. 

c. Once you know the IP address of your server (as provided by the 
search, or by the nsiookup command), boot the system by typing 
the foil owing: 

boot Ian . nn.n.nn.n install 

For nn.n.nn.n, supply the network address of your server. 

The system then begins to load the install kernel from the 
network server. 

Time Note This should take 3 to 5 minutes. 


Description 

Display or set auto flag 

Boot from primary,alternate or SCSI 

Boot from LAN 

Enable chassis codes 

Enable/disable diagnostic boot mode 

Display or set fast boot flag 

Display the command menu 

Display system information 

Display LAN station addresses 

Select monitor type 

Change boot path 

Display PIM info 

Display potential boot device 

Display or set security mode 
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Booting from a Network (Workstation/Series 700, B, C J Only) 


System Configuration 

Whether you booted the install kernel from the media or from a network 

source, after your system is running it will analyze your new system for 

the following information: 

1. The install kernel location and (disk) device identities connected. 

2. Console tty settings, keyboard language (itemap) and EISA cards. 

3. The default configurations from the LI F volumeof the I nstall Media 
(named "CONFIG"). You may be asked for network information if it 
cannot be determined automatically. 

4. A copy of theconfiguration filecusTOM, in the LI F area of any disk on 
the system. 
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Installing and Configuring the 
Operating System 

1. After you have booted the I nstall program, from the network or from 
the install media, as previously described, the I nstall interface will 
automatically be displayed as follows: 


Figure 2-9 


Welcome to the HP-UX Installation process! 

Use the <tab> and/or arrow keys to navigate through the following menus, 
and use the <return> key to select an item. If the menu items are not 
clear, select the "Help” Item for more information. 


Install HP-UX 


[ Run a Recovery Shell ] 
[ Cancel and Reboot ] 
[ Advanced Options ] 
[ Read Sys—Admin Message ] 


[ Help ] 


This Welcome screen is the first of several screens that will guide you 
through the installation process. Use your Tab key to highlight items 
on the screen. Press Enter to choose or activate the highlighted item. 

2. Select I nstall H P-UX. 

The I nstall program will continue. 

Configuring for Network Installation 

In the following screen, you will be asked for information about 
networking. 

If the system is NOT currently booted from a network, it will display the 
following: 


Figure 2-10 
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Installing and Configuring the Operating System 


If you plan to use a network software depot to load the operating 
system, you will need to enable networking at this time. 

Would you like to enable networking now?[y] 

Answering "n" means that you intend to install entirely from the media 
and the I nstall Kernel continues to load. 

Answering "y" brings up the following screen if you have more than one 
LAN card: 

(If you have only one LAN card, you will seethe Network Configuration 
screen next (Figure2-12). 

Figure 2-11 


More than one network interface was detected on the system. You 
will need to select the interface to enable. Only one interface 
can be enabled, and it must be the one connected to the network 
that can be used in contacting the install and/or SD servers. 


Use the <tab> and/or arrow keys to move to the desired LAN device 
to enable, then press <Return>. 


HW Path Interface Station Address 


12/0/2 


lanU 


0x080009150315 


[ 4/0/3 


lani 0x080009141404 


] 

] 


1. ChcxDsethe LAN interface that you will be using for this installation. 
(Notethat only Ethernet can be used for installation.) 

2. You will next see the following Network Configuration screen. Some 
of this information will have been filled in for you if you have 
configured the Dynamic Host Configuration Protocol (DHCP). See 
Appendix B, "Configuring for a DHCP Server,"for more information. 

Figure 2-12 
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Installing and Configuring the Operating System 

HP-UX INSTALLATION UTILITY NETWORK CONFIGURATION 

This system's hostname:_ 

Internet protocol address (eg. 15.2.56.1) of this host:_ 

Default routing internet protocol address:_ 

The subnet mask (eg. 255.255.248.0 or OxfffffSOO):_ 

Internet protocol address of the Install Server System:_ 

Is this networking information only temporary? [ No ] 

[ OK ] [ Cancel ] [ Help ] 

3. If not a I ready filled in, this information must beentered, if you plan to 
usethe network to install any portion of theoperating system or 
application products. (This information will not berequired if you are 
installing the entire system from CD-ROM). An additional 

line, ("...Install Server System"), appears Only when booting from 
a network. 

4. For the question about the network information being temporary: 
"temporary" means that the network IP address will be used as 
default information during the install process and to fill in the fields 
of the system configuration screens. The "temporary" status will also 
prevent DHCP from retaining the "lease" on this IP, as it would if the 
network information were marked "permanent". See Appendix B, 
"Configuringfor a DHCP Server,"for detailed information on what 
leasing entails. 

You will see the system configuration screens after the OS is installed 
and the system reboots. 

The default response for this question is "no". I f you press the space 
bar (or Enter) when the cursor is on this field, "yes" will be displayed. 

5. Choose OK when you have finished with this screen. 
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Selecting the Root Disk 

If you have more than one target disk, after you have finished with the 
Install Welcome screen, you will see the Select System Root Disk screen. 
If you have only one disk, skipto "Viewing or Modifying Configuration". 


Figure 2-13 



NOTE Shortcuts 

Ti ps for usi ng the i nstal I i nterface: 

• Ifyou prefer to use the keyboard to manipulatethe I nstall interface, 
you can do so by typing the underlined letter of an item (such as "C" 
for cancel). 

• For help, choose the Help button at the bottom of each screen. Press n 
or CTRL-f for context-sensitive help. 

• Use CTRL-k to get navigation key help. 


1. Select your root disk by using the arrow keys to highlight the line for 
that disk. (I n the above example, the system found two disks.) 
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Selecting the Root Disk 


2. With the desired disk highlighted, chcxase it by using Tab to select OK 
and press Enter. 

• If the disk you want is not shown, make sure it is turned on and 
connected to the system. You may select Cancel to exit this menu. 
If you do this, you will be presented with the option to restart the 
installation at the beginning of the configuration utility or scan 
the system again for disks. 
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Viewing or Modifying Configuration 

If you selected OK on the previous screen, or if you have only one target 
disk, you will next seethe Select Whole-System configuration screen. 
This screen asks for the file system layout you want. Standard 
Whole-Disk (non-LVM), LVM ("Logical Volume Manager"), or LVM with 
VxFS (J ournaled File System). 


Figure 2-14 



Workstation installation isshown as Standard Whole-Disk (non-LVM). If 
a disk is larger than 2 GB, LVM is required. 

The default for Servers is LVM configuration, with the exception of disks 
smaller than 1GB. In most cases, especially with multipledisks, you will 
want to configure as LVM. 

1. Use the arrow keys to highlight your selection. 

The descri pti ve text at the bottom of the screen changes for each 
highlighted selection. You can scroll through thetexttoget more 
information about each selection. 

2. Select the option you want, tab to OK and press Enter. You will next 
seethe View/Modify Basic Configuration screen. 
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NOTE Starting from the H PUX 10.20 version, /stand is created as a 

separately mounted file system. The / stand filesystem will always 
reside on the first logical volume on the boot disk. 

The following default sizes will be used for the root and the boot file 
systems: 

Root FS "/" : 84 MB 

Boot FS "/stand" : 48 MB 

You can choose either H FS or VxFS as the root filesystem. 


For More Information To find out more about LVM and VxFS, see the manual System 

Administration Tasks. The basic procedure for installing the optional FI P 
Online] FS Product, which gives you the complete functionality of VxFS, 
is in "I nstalling the Optional Online] FS Product", in this manual. 


NOTE For newer Server systems with a selected system root disk that is 

smaller than 1GB, non-LVM configuration is the default selection. This 
is in order to accommodate the FI P-UX 10.x file system layout. The LVM 
configuration calls for separate logical volumes to contain (at least) the 
following: 

/, /usr, /stand, /opt, /var, /tmp, and "primary swap" 

On a small root disk, it is better to load everything under the root file 
system ("/") and take advantage of a common pool of free disk space. 

If your system has multiple disks and you want to combine more than 
one disk intotheLVM root volume group, override the Standard 
Whole-disk default for "smaller disks", and specify Standard LVM 
configuration. 
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View/Modify Basic 
Configuration 

Figure 2-15 


HP-UX Install Utility — View/Kodify Basic Configuration 


You may modify t;he following basic 

configuration 

parameters. Press 

OK to 

save your changes. 





Primary Swap Size 

D tH t.lM tl] 



Secondary Swap Size 

[ 

None —> ] 



Software Selection 

[ 

CDE Runtime 

Environment 

— 

Load 10.20 Software Enhancements 

[ 

False —> 3 



Software Language 

[ 

English 

->] 


Locale Setting 

C 

default (C) 



File system file name lengtii 

[ 

Long —> ] 



/home Configuration 

[ 

Minimal 

->] 


How many disks in root group 

[ 

One 

->] 


Make volatile dirs separate 

[ 

True ->] 



Create /export volume 

[ 

False “>] 



t OK ] [ 

Cancel ] 

[ 

mmam 


This screen allows you to modify disk configuration. The screen shown 
above is for an LVM configuration; not all of these fields will appear on 
the non-LVM screen. 

Pressing Enter (or the space bar) at each question will display a 
mini-menu for that item. If you need to change a parameter, use the 
arrow keys to highlight the selection on the mini-menu and press Enter 
again tochoosethat selection. 


NOTE To load only OS-related software without ON C-l-software enhancements: 

leavethe value "false" for the question "Load 10.20 software 
enhancement s ". 


Help information which is specific to each parameter can be displayed by 
pressing fl (or CTRL-f) while the parameter of interest is highlighted. 

One of the parameters you can choose in this screen is "Software 
Language." Seethe manual Localized System Configuration Overview 
(HP Part No. B 3782-90095) for additional requirements for each 
language. 

You can also select the Locale setting for your system. This will 
determine other language-environment conventions such as time and 
monetary conventions in software messaging. 
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If you plan to configure multiple disks into the root volume group, you 
should ensure that the selection Make Volatile Dirs Separate is set to 
True. This allows the root filesystem to expand as needed and the 
vol umes to be spread across more than the root disk. (See "Adj usti ng FI le 
System Size"for details on expanding a filesystem after installation.) 

Choose OK when you have made your selections. 
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Configuring the Disk and File System 


Figure 2-16 
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A screen display similar to this summarizes your configuration and 
allows you to make modifications by selecting Modify Disk Parameters or 
Modify FS Parameters. You can also accept the default values by tabbing 
toOK and pressing Enter. If you dothis, gotoFigure, "Loading the Core 
Operating System," in this chapter. 


• If you select Modify Disk Parameters or Modify FS Parameters, you 
will see a screen for additional parameters. (The disk in the example 
is in the root volume group( "vgOO"). 

• Choosing Cancel will return you to the previous screen. 


NOTE If you choose OK, you may see a warning screen indicating that one or 

more of your target disks already has a file system on it. 

I n the warni ng screen, choose Conti nue to proceed, if you are not 
concerned about any data that may exist on the target disk. OR 

If you want to change target disks, choose Modify Configuration and 
Cancel to successively "back out" to the Root Disk Selection Screen. 
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Specifying Disk Usage If you selected Modify Disk Parameters, in the screen shown in Figure 
2-16, you will see a screen similar to the foil owing: 


Figure 2-17 



Using this screen, you can modify disk usage or parameters. The most 
typical use of this screen would be to configure a second disk. 

For example, you could modify the disk configuration first, and then go 
on to modify the file system, as in the following sample procedures. Tab 
to OK and press Enter if values are satisfactory. 

Example: 1. On the Specify Disk Usage screen, select a disk with the arrow keys 

and tab to the fil I -i n fields to change any of the usage items. N ote that 
the "blank" fields allow direct entry of information; the bracketed 
fields have underlying mini-menus which you can display by selecting 
the item and pressing the space bar. I n a mini-menu, highlight an 
item by using the arrow keys and choose it by pressing Enter. When 
you have finished, use arrow keys to highlight Modify (if you have 
made modifications) and press Enter. 

2. To modify disk or volume group parameters (LVM), or simply usethe 
defaults, choose from the following actions: 
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• Tab to Modify Disk Parameters... and press Enter. You will see 
Figure 2-18. Go to the next section, "Modifying Disk Parameters". 
OR 

• Tab to Modify Volume Group Parameters and press Enter. You will 
see Figure 2-19. Go to the section "Modifying VolumeGroup 
Parameters". OR 

• Tab to OK and press Enter to leave the screen when everything is 
satisfactory. Go to the section "Loading the Core Operating 
System", in this chapter. 

Modifying Disk If you selected Modify Disk Parameters in the screen shown in Figure 

Parameters 2-17, you will seea screen similar to the foil owing: 

Figure 2-18 



NOTE Before you make any modifications to the sub-screens, please note the 

following: 

• Thedefault parameters areusuallysuitableand should not be 
changed unless your disk situation is unusual. 
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• I nitializing a disk ("mediainit") is both time consuming and generaiiy 
unnecessary, except in theuniikeiy event that thedisk has incurred 
iow-ie/ei formatting damage due to a controi maifunction. 


if necessary, make any modifications and tab to OK. Then press Enter. 

Modifying Voiume if you seiected Modify VoiumeGroup Parameters (LVM oniy) in the 
Group Parameters screen shown in Figure 2-17, you wiii see a screen simiiartothe 
foii owing: 

Figure 2-19 



if necessary, make any modifications and tab to OK. Then press Enter. 

After you have viewed or modified the parameters in each sub-screen, 
you wiii seethe Specify Disk Usage Screen (Figure 2-17) again 
summarizing the current status of disk usage. 

Configuring Fiie if you seiected Modify (FS) Parameters in the screen shown in Figure 
Systems 2-16, you wouid seea screen simiiar to the foii owing: 
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Figure 2-20 Configure File Systems 



On this screen, you can configure file system space and usage, and you 
can also change Logical Volume parameters or other file system 
parameters in subsequent screens, as needed. As with disk usage the 
default parametersareusuallysuitableand should not be changed unless 
your filesystem requirements are unusual. 

Example: You can change file system configuration by doing the following: 

1. Move the cursor to highlight the mount directory item, such as 
"/home", in the top box. Use the arrow key to move the cursor within 
lists, and use the Tab key to move between lists and major items. 

For example: 

a. Use Tab to move the cursor to the "Size" field, or another item in 
the lower half of the screen. 

b. Leave the default size or change it to another appropriate value. 
To edit, you can backspace over the old entry and type in a new 
one. For the fields followed by ">", highlight thefieid and press the 
space bar to get a mini-menu of selections. FI ighlight one of these 
and choose it by pressing Enter. 

c. When you have finished, choose Modify (for changing volumesize) 
or choose Add or Remove for other changes. 
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d. When you are satisfied with the parameters, choose OK to accept 
the changes and return to the System Configuration screen. 
Otherwise, choose Cancel to reject the changes and return to the 
previous screen. 
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Loading the Core Operating System 


Figure 2-21 



When you have finished with configuration or elected to use the default 
values by choosing OK at the System Configuration screen, you will see 
this screen. 

Note you will not be asked for theSD-UX server I nternet Protocol 
address, unless you have booted from the network. 

If you booted from media but you want to load theOS from the network, 
you can make this choice later when theinstall program prompts you to 
change media. Otherwise, if you booted from CD-ROM and you want to 
load the OS from the network, you will need to interact with SD in order 
to change sources. 

Toinstall the required bundles/products from the product media, the cold 
install process invokes the SD-UX swinstaii command. You can choose 
to work with this utility interactively or non-interactively. I nteracting 
with the swinstaii utility gives you additional flexibility in choosing a 
specific set of products/filesets. 

• If you choose No as in the example (to load the standard 

bundles/products without interaction), swinstaii will proceed with 
theinstall, loading the appropriate bundle, based on your software 
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Time Note 


selections in the View/Modify Basic Configuration screen (see Figure 
2-15). While doing this, it displays the activity logs (monitoring the 
install process as it happens) and the list of default values it uses to 
install the software. 

• If your server (or media) has needed applications on it, such as 
multi-user licenses or a C compiler, you will want to interact with 
swinstaii. In that case, choose Yes (to load bundles/products 
interactively). Then you will seethe swinstaii user interface. 

Many system administrators or users may want to customize individual 
products and filesets. This is easily done by interacting with the 
swinstaii Utility which "reads" the list of software available on the 
installation source and displays it. At this point, you may go through the 
list and "mark" individual filesets for installation and ignoreothers. You 
can also "open" bundles, products and filesets and list their contents, 
using the interface. Each software object also has its own description file 
which can be read to get more information about the item. 

• If you are installing from the network, the install utility will also 
request the SD-UX Server IP address and the SD-UX Server depot 
directory. You can also have a depot set up on the server using 
swcopY, and you can use swreg to register a mounted CD-ROM on 
the server. See Managing HP-UX Software with SD-UX for this 
version, for more information. 

• After you indicateyour choice, the install utility will proceed with 
configuring your disk(s) and file systems. 

• The initial configuration will require about five minutes. 

• After the configuration is complete, the install process will proceed 
with loading the software. The load process will require 30 to 60 
minutes, depending on network performance and the number of 
products to be loaded. 

The system reboots after loading the software. 

Specifying System Information 

When the installation ends and the system reboots, you will see a system 
information screen requesting the foil owing system information. If you 
are using a DHCP server, some of the IP address and host name 
information will already be filled in. (See Appendix B, "Configuring for a 
DHCP Server,"for further information on DHCP.) 
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1. The hostname for your system. 

2. The region (e.g. "North America") for your time zone, or press Enter, if 
the selected item in the list is correct. 

3. The local time zone. Confirm the time zone, or press Enter if the 
information is correct. 

4. The local time. Confirm the time and date or press Enter if the 
information is correct. 

5. A password. Re-enter it as requested. 

6. The internet (I P) address of your host system. Confirm the host 
internet address or press Enter. 

7. If your system is connected to a network, fill in additional network 
parameters as requested. Otherwise respond "n" to the questions 
about additional parameters. Network information will typically be 
provided by your network administrator; not all of these items will 
usually be needed. 

Use Tab to move between fields: 

• Subnetwork Mask and Default Gateway. 

• Subnetwork Mask (for example, 255.255.248. o or 

OxfffffSOO). 

• Gateway H ost N a me. 

• Gateway IP Address. 

• Domain Name System (DNS). 

• Domain name. 

• DNS System Host Name. 

• DNS IP Address. 

• Network I nformation Service (NIS). 

• NIS Domain Name. 

• The Setup Font Client screen enables you to save disk space by 
havi ng H P VU E access character fonts over the network. I f you 
wish to do this, you can click on Yes and provide any additional 
information. Otherwise, click on No. 
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• I f you haven't al ready configured the network, the System 
Parameters screen gives you path information for the 

/sbin/set_parms 

addi_netwrk command. Click on Close or press Enter. 

• You will seethe boot checklist display, which should require no 
interaction. The initial boot of your system after a cold install or 
an update may take somewhat longer than later boots. 

You will seethe login interface for HP VUE (or CDE, if installed), 
or the terminal login prompt. Log in as root and press Enter at the 
request for password, unless you set a password duri ng the system 
information procedure. 
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Verifying and Completing the 
Installation 

When you have completed the OS installation steps, the system will 
automatically reboot from the new system disk. Then you will be ready to 
start building (or re-building) your system by installing other software 
and data files, setting up printing facilities and connecting additional 
peripherals, as needed. 

To verify that you have HP-UX 10.20 (ACE or H WE) running on your 
system, execute the following command: 


$ uname -r 

Listing Installed Applications 

You can list the contents of your install or update media at various levels 
of detail by using the List button or the View menu during an 
installation or update. To list all applications on your system, after 
HP-UX is installed and booted, type the foil owing: 

swlist -1 bundle 

This will list all SD-UX format software application bundles that have 
been installed in thedirectory on your system. To determine if ACE 
or Hardware Extension bundles are installed, pipe the command to grep 

ACE IHWE. 


The swlist utility creates customizable lists of software products that 
are installed on your local host or software that is placed in depots for 
later distribution. Seethe Managing HP-UX Softwarewith SD-UX (HP 
Part No. B2355-90080) manual or the manpages for swlist for more 
information. 

You can also use swlist with your install media to obtain a listing of 
bundles and products. 


58 


Chapter 2 





Installing HP-UX 

Verifying and Compieting the instaiiation 


Removing Unwanted Software/Filesets 

If it is necessary to remove software that has been installed on your 
system, usethe swremove utility. The swremove utility also 
unconfigures the software as it removes it. 

It is possible to remove your 10.20 ACE or Hardware Extension software, 
although the system may have to manually rebooted, as follows: 

• Use swremove to remove the appropriate ACE bundle. 

• Exit swremove session after the bundle is removed. 

• cd / 

• /etc/shutdown -r -y 0 

After the system has rebooted, the software will have been successfully 
removed from the system. 

Running freedisk 

Another method of removing filesets from your system is to usethe 
HP-UX freedisk command. The freedisk command invokes an 
interactive script that finds and optionally removes filesets that do not 
appear to have been used si nee they were originally installed by 
swinstaii. This command is best run AFTER your new system has been 
in operation for sometime Seethe manpageon freedisk for more 
information. Note, you should be familiar with the swremove command 
before you use freedisk. 

Creating a Recovery System 

You should immediately make a recovery version of your new system 
after you have successfully installed it. This will help you recover your 
system in case of problems. The Support Media User's Guide provides 
instructions on how to usethe copyutil disk copy utility to make an 
image of your system disk after installation. The manual is included in 
the Support M^ia available through Subscription Services or orderable 
from HP. You can also find information on restoring and backing up your 
system in the manual HP-UX System Administration Tasks. 
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Multi-User License Software: If you are loading H P-UX from a 
CD-ROM, multi-user licenses (to allow more than two users on the 
system) are on one of the additional Application CDs, which also 
contains optional products such as LVM disk mirroring. 

This means that, when your system reboots after loading the software 
from the first CD, no more than two users will be able to log back in. If 
yours is a multi-user system, you must load your multi-user license from 
another application CD before bringing the system back online. You may 
want to set up a network depot to make this process easier. 


Installing Extension Software 

The Extension Software which comes with HP-UX contains essential 
patches and hardware-specific updates for the current version of H P-UX. 
If you are updating with theHP-UX Extension Software, please go to 
"Updating HP-UX Software"and "Using HP-UX Extension Software", in 
this chapter, to get information. The system will automatically reboot 
after updating with kernel-related Extension Software. 

Installing Applications Software 

For the procedures for installing additional software from CD-ROM or 
network depots, see "Updating HP-UX Software", in Chapter 3, 
"Updating H P-UX," in this manual. Or seethe manual Managing H P-UX 
Software with SD-UX. 

You will also find further instructions on building your system in the 
System Administration Tasks manual. 
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Updating HP-UX 


Updating your system from the existing HP-UX lO.Ox, to HP-UX 10.20 
reieases invoives using swinstaii and other SD-UX toois with a 
standard source, such as a network server or CD-ROM, to instaii the 
appropriate bundies, products, or fiiesets. 

Upgrading means using a suite of toois (version 9.U 3 of the Upgrade 
toois) to update your system from H P-UX 9.0x to lO.Ox. For upgrading 
your system, refer to the manuai U pgradi ng from HP-UX 9.x to 10.x. 

• if you pi an to update from HP-UX 10.0 to 10.20, you wiii have to 
update your system first to H P-UX 10.01. 

• it is highiy recommended that you do a system backup before starting 
to do an update. 

• if you areupdatingfrom HP-UX lO.lOor eariier, you wiii havetofirst 
update SD-UX (the set of toois that inciudes swinstaii), using 
swgettoois, before you can run swinstaii. 

Executing swinstaii to update from 10.0,10.01, or 10.10 to 10.20 wiii 
not succeed uniess you first obtain and execute the swgettoois 
command found on the 10.20 media. This wiii update the SD-UX 
commands. Faiiure to update SD-UX from the oid version wiii resuit in 
error messages and faiiure of the update process. 

The instructions for using swgettoois are in "Updating SD-UX Before 
i nstaiiing/Updating Software", in this chapter. 

• if you ai ready have H P-UX 10.20 via i nstant ignition or thecoid 
instaii procedures in Chapter 2, "instaiiing HP-UX," go to "Updating 
HP-UX Software", in this chapter. 

• if you are doing an OS update from a patched version of HP-UX 10.x, 
after updating, you wiii need to remove oid patches using the 
cleanup tooi. See the note at the end of the update procedure. 
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Paths 


Memory and Disk 
Space Requirements 


HP-UX 10.20 System Requirements 

For general system requirements for updating, please see "H P-UX 10.20 
System Requirements" in Chapter 1, "Before You I nstall." 

You can use the SD-UX tools to update your OS to H P-UX 10.20 from 
either 10.10 or 10.01. For upgrades from 9.0x, seethe manual Upgrading 
from FI P-UX 9.x to 10.01. You can also use SD-UX to I nstall or update 
applications. 

• FI P-UX 10.20, including NFS and LAN/9000, requires 16 MB of RAM. 

• Before you begin the update, you should be sure your target disk has 
the space needed to accommodate the new OS as wel I as your data 
files and all needed backups on disk. FI P-UX 10.20 requires 271 MB, 
including NFS, LAN software and X Windows. This means you should 
plan on a minimum of 525 MB for a standalone workstation. Disk 
usage numbers will vary with the SD-UX installation by a factor of 
20 %. 

I n general, the Disk Space Analysis phase of swinstaii will warn 
you if disk space is insufficient. Flowever, Disk Space Analysis does 
not currently check /var/adm/sw, where the database is kept, for 
temporary space usage. 

If you are running your system as LVM and /var comprises a single 
volume, be sure you have configured adequate space in the /var 
vol u me to accommodate t he u pdate fi I es. U pdate requ i res a mi n i mu m 
amount of free disk space of at least 20 M B to allow for the generation 
of the installed software database, among other things. 

1. Determineyourfreediskspacein /var by runningbdf /var and 
bdf /var/tmp. The default temporary directory is /var/tmp. 

2. Delete any files in this volume that you don't need. 

3. If necessary, set the environment variable tmpdir to point to a 
directory that has sufficient space. For example (for a directory 
dir): 

TMPDiR=/dir 

After setting this variable, export it, and kill and restart the 
swagentd process. 
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/usr/sbin/swagentd -r 

4. E nsurethat your system has at least 30 M B of swap enabled bd'ore 
start! ng the update process You can use swapinf o -mt and check 
the total free M B of swap space. Or you can use SAM to see how 
much swap you currently have. If you do not have enough swap, 
you can enable filesystem swap for the duration of the update 
(until system reboot) by using the following command: 

/usr/sbin/swapon /var/tmp 

The directory /var/tmp can be used if there is sufficient free 
space. If /var/tmp Isfull, then specify a different volume that has 
enough free space to satisfy the swap space requirement. 

Alternatively, you can shut down unneeded programs to make 
more memory and swap space available. This also improves 
performance, especially in 16 M B systems. 

• Before updating, you may wish to use /usr/sbin/swremove to 
remove unneeded filesets from your system. You can use the 
freedisk tool on a system which has been active for a timetodetect 
unused filesets. 


For More Information 
on Space 
Requirements 


Refer to the current System Administration Tasks manual and the 
Release Notes for HP-UX 10.20 for additional information on peripherals 
and disk space. 


CD-ROMs Used SeeChapter 1 for the Media list for this release. 


NOTE If you are updating any networking products, such as FDDI or 

Token-Ring, which arenoton theHP-UX Insrtall and CoreOS CD, please 
see "Networking Products on Additional Media". 


Starting the Source Media 

1. Notethat your multi-user license is typically supplied on separate 
media. 

2. E nsure that you have made a backup tape of your present system. 

3. Ensure that your system is booted and running HP-UX 10.x. You 
should have a term window opened. 

4. Turn on the CD-ROM drive, if it is external to your HP-UX 10.x 
system. 
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5. I nsert the CD-ROM into its drive. 

6. Wait for the busy lights to stop blinking. 

7. If necessary, identify the drive device, using the /etc/ioscan 
-fn command. 

8. If you are using a CD-ROM, note that you will first have to mount the 
disc, using SAM or the mount(lM) command. If you do not use SAM, 
you can do the following to mount the disc: 

a. Put the CD into the CD-ROM drive. CD-ROM "busy light" should 
blink. 

b. Open a term window and, at the shell prompt, type the foil owing: 

mkdir /SD_CDROM Enter 

I f not created by col d i nstal I al ready. 

mount / da//dsk/clt2dO /sd_cdrom Enter 

The device name "clt2d0" should be replaced with whatever 
device name you found using ioscan in item 7 above. 
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CAUTION 


Procedure 


Loading swgettools 


Getting the New SD-UX 
Tools 


Updating SD-UX Before 
I nstal I i ng/U pdati ng Software 

Before you can update to 10.20, you must extract the new version of 
SD-UX from the 10.20 CD or software depot from which you plan to 
update your system. 

Do not attempt to use the 10.01 or 10.10 version of swinstaii to update 
the system to 10.20. The update will fail. The swciuster command, 
used to update an NFS Diskless server, will also fail, since it calls 

swinstaii. 


To update SD-UX, you must first load the swgettools utility onto your 
system, and then use swgettools to get the new version of SD-UX. 

The swgettools command needs a temporary directory with at least 11 
MB of free space. By default, swgettools will usethe /var/tmp 
directory. If there is not enough space in the temporary directory 

swgettools will fall. 

You can tell swgettools to use a different temporary directory by 
means of the -t dIr_path command-line opt!on. You must do this if you 
do not have 11 MB free in /var/tmp. Usebdf /var/tmp to determine 
this. 

The swgettools Utility is shipped in the catalog/SW-DISI/pf lies 

directory. Depending on whether the 10.20 software is on CD or a remote 
system in a software depot, use cp, tar, or rep, respectively, to load 
swgettools ontoyour system. Skip to the section "SW-DIST 
I nstallation" below for more examples and other options. 

For example, to load swgettools from a local CD-ROM mounted at 
/SD_CDROM into /var/tmp, enter the following: 

cp /SD_CDROM/catalog/SW-DIST/pfiles/swgettools /var/tmp 

Now use swgettools to Update SD-UX. For example: 

/var/tmp/swgettools -s /SD_CDROM 

The expression -s /sd_cdrom indicates a CD-ROM drive mounted at 

/SD_CDROM. 
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CAUTION 

Further examples are in the next section. After you have updated 

SD-UX, you can use swinstaii to update your system to H P-UX 10.20. 

Do not reboot your system after running swgettools and before you run 

swinstaii Or swcluster tO Update H P-UX. 

If you do reboot, you must run swgettools again before updating 
HP-UX. 

From CD-ROM 

SW-DIST Installation 

To install the new sw-dist product from CD-ROM at /sd_cdrom, enter 
the foil owing: 

cp /SD_CDROM/catalog/SW-DIST/pfiles/swgettools /var/tmp 

/var/tmp/swgettools -s /SD_CDROM 

From Tape 

To install the new sw-dist product from tape at /dev/rmt/Om, enter 
the foil owing: 

cd /var/tmp 

tar -xvf /dev/rmt/Om catalog/SW-DIST/pfiles/swgettools 

cp /var/tmp/catalog/SW-DIST/pflies/swgettools /var/tmp/swgettools 

rm -rf /var/tmp/catalog 

/var/tmp/swgettools -s /dev/rmt/Om 

From Remote Depot 

To install the new sw-dist from a remote depot on system swperf at 
/var/spooi/sw, enter the following: 

rep swperf:/var/spool/sw/catalog/SW-DIST/pfiles/swgettools /var/ 
tmp 

/var/tmp/swgettools -s swperf:/var/spool/sw 

Updating SD-UX Without Root Access to the 
Remote Depot 

Option 1: 

If you area system administrator, you can instruct your users to use this 
procedure or Option 2 (below) for more restricted access, if you do not 
want to grant the users rep (. rhosts) access as root to the server. 
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1. Copy the swgettools script file (in the catalog/SW-OIST/pfiles 

directory) and the swagent. z file (in the 

cataiog/sw-GETTOOLS/pfiies directory) from the tape or CD toa 
location that your users have FTP access to. 

2. Tell the user to do the foil owing: 

a. FTP the two files into the /var/tmp directory on the system to be 
updated. 

b. Usechmod -i-x to make the /var/tmp/swgettoois script 
executable. 

c. Run swgettools and specify the remote depot location with the 
-s option (and, if necessary, -t to specify a temporary directory 
other than /var/tmp). 

Option 2: This option assumes your users will be running swgettools specifying 

a source depot on a remote server, and you do not want to grant them 
rep (. rhosts) access as root to the server. 

U sers can use the SD-U X swcopy command to copy the sw-gettools 
product from a registered remote source depot to a local depot prior to 
extracting the files. The remote source depot can be either a CD-ROM or 
a disk depot. 

Tocopy the SW-GETTOOLS product from the remote CD-ROM depot 
located at swperf :/var/spooi/sw to a local depot in /tmp/depot: 

swcopy -s swperf:/SD_CDROM SW-GETTOOLS @ /tmp/depot 

Then copy the swgettools script and the swagent. z filetothe 
/var/tmp directory: 

cp /tmp/depot/catalog/SW-GETTOOLS/pfiles/sw* /var/tmp 

Executethe swgettools script specifying the remote depot to update 
the sw-DiST product from the following: 

/var/tmp/swgettools -s swperf:/SD_CDROM 

NOTE If you will be using a temporary directory other then /var/tmp, then cp 

the swgettools script and the swagent. z file to the temporary 
directory you will be using, and specify its location on the swgettools 
command lineusingthe-t option. 


EXBmpIO: cp /tmp/depot/catalog/SW-GETTOOLS/pflles/sw* /usr/tmp 

/usr/tmp/swgettools -s swperf:/SD_CDROM -t /usr/tmp 
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Updating HP-UX 

Updating SD-UX Before Installing/Updating Software 


Consult the swgettools(lM) man page (on a 10.20 system) or the manual 
Managing H P-UX Software with SD-UX for assistance with the 
following: 

• If you encounter an error during the execution of the swgettoois 
script. OR 

• If you want to see examples of using swgettoois with other types of 
media. 
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Updating HP-UX Software 

If you are updating software on an existing H P-UX 10.20 system you 
should begin the update procedure at this point. 

Otherwise, you should have installed the new sw-dist product first, as 
given in the previous sections in this chapter. Then do the following to 
start swinstall: 

On Series 700, you will see a Graphical User I nterface (GUI), by default. 
On Series 800, you will see a character display Terminal User Interface 
(TUI) on a console. You will have a GUI if you are working from an 
Xterminal. 

Updating a Single System or Series 800 
Server-Cluster 

1. For a Series 800 serving Series 700 clients, or for a non-clustered 
system, enter the Software Management area of SAM and select 
Install Software to Cluster/Local Host. Or enter the following: 

/usr/sbin/swinstall 

2. You will seethe swinstall Specify Source screen in Figure 3-1. Skip 
to the section "Specify Source Screen". 

Updating a Cluster 

If you are updating Series 700 cluster clients or a Series 700 serving 
Series 700 clients, enter the Software Management area of SAM and 
select I nstall Software to Cluster. Or you can use swciuster, as follows: 

1. Enter the swciuster command for interactive mode: 

/usr/sbin/swcluster -i 

(swciuster will shut down the cluster clients if you are updating 
kernel software): 

You will seethe swinstall interface. The screens are similar to 
those used for the non-clustered procedure below. 

2. Select the default shared root (/export/shared_roots/os_700) in 
the interactive window. 
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Time Note 
NOTE 


3. Select the software source host and depot. 

4. Select software as desired, or Match what Target Has from the 
Actions menu. 

5. Select Install/Analysis from the Actions menu. 

6. After the analysis phase finishes, select OK to conti nue with the 
cluster install process. 

For screen details seethe non-clustered installation in the next section. 

Installing or updating an operating system or kernel software to a 
shared root shuts down any clients booted from that server and reboots 
the server. If you are installing non-kernel applications to a shared root, 
the clients will not be shut down and the server will not be re-booted. 

When the server has rebooted and finished the startup process, turn on 
the diskless clients. They will boot and configure the software. 

Note that, on a Series 800 server-cl usta, this process will only update the 
(Series 700) clients. 


If you are updating a large cluster, this process could take several hours. 


Updating a diskless cluster server from HP-UX 10.01 to 10.20 may result 
in the following messages appearing in the swagent. log file (located in 

/export/shared_roots/ os_7 0 0/ var/adm/sw). These warnings may 
be safely ignored. 


WARNING: 

his 

WARNING: 

.CFG" 

xist 


Beginning the Batch Swmodify Phase 

Cannot delete the definition for "/sbin/sh.UPG" from the 
fileset "OS-Core.UX-CORE". The file does not exist in t 

fileset. 

Cannot delete the definition for "/sbin/lib/eisa/HWP0C70 
from the fileset "OS-Core.UX-CORE". The file does not e 
in this fileset. 


The listing continues, with similar messages referring to: 

/sbin/lib/eisa/ HWPXnnnn.CFG 
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Specify Source Screen 

Figure 3-1 


specify the soiirce 

ype, I lieu host name, then t 

itt }i on 1 li«it lio: t . 

Source Depot Type; 

|Hetwork Directory/CDROM 


j Source Hii'.t Name. 

. . swatch 

1 




I Source Depot Path. 

/SD CDROM 

1 

I Software Filter... 

•• ’.is 

None 



I OK 

I ( .IMLCi 



1. Clicking on the field beside Source Depot Type displays a choice of 
Local CDROM, Local Directory, Local Tape, or Network 
Directory/CDROM. The latter category will get a remote source for 
the update. 

2. If the source depot/host name filled in is not the one you want, enter 
the correct one. You may also use the IP address for a host. 

3. If you click on Source Depot Path, you will get a listing of available 
depots on the source you have just specified. If the source is a tape 
device, you may need to type the device file name. The mount point 
for a CD-ROM should already exist as /sd_cdrom, if the system was 
cold-installed. For more detail, see the man pageswreg(lm). 

4. If you wish to limit the listing, click on Software Filter to see the list 
of filters protocols available. At the same time, you can select one or 
none. 

5. Click on OK. 

You will next seethe Software Selection screen. 

For More Information For information on the options for swinstaii, and to change the degree 

of detail for its logging functions, see the manual Managing FIP-UX 

Softwarewith SD-UX. 
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Software Selection 
Screen 
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Figure 3-2 


• On the Software Selection screen, highlight an item and click on the 
Actions menu item Open Item to see a listingof the contents of that 
bundle or product. You can also successively double-click on the 
selected item to show the contents at the next level of detail. To see a 
general description of the selected software, click on Show 
Description of Software from the Actions menu. Click on the OK 
button when you have finished with the description screen. 

If you want to match the general filesets and functionality you 
already have on your old system, choose Match What Target Has ... 
from the action menu, AN D/ OR 

• To choose specific bundles/products to add to the M atch What Target 
Has ... selection, highlight the additional item, and then choose Mark 
for I nstall from the Actions menu. (You can also use the right mouse 
button to mark for install). 

• Tostart the install process, choose I nstall (analysis)... from the 
Actions menu. You will see the foil owing screen (superimposed): 
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Install Analysis Screen 
Figure 3-3 


After Analysis has completed, press 
to return to priar selection screen(E 

iTarget ? i : swatch:/ 

P Status 8 1 : Ready 

fiProducts Scheduled : 1 of 2 

OK’ to proceed, or ’CANCEL’ 

0. 

|i| Product Summary... 

Logfile... 

1 Disk Space... | Re-analyze 

OK 

1 Carice 

1 Help 


• By clicking on the Logfile button, you can open the logfileto monitor 
the progress of the analysis. You will also see a listing of files already 
on the target system which will be reinstalled in new versions. The 
Disk space... button will become accessible after the analysis process 
is complete and you can view the results (see Figure 3-4). 

• Click on OK to proceed. 

Time Note The analysis phase requires 5 to 10 minutes. 
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Disk Space Anaiysis 
Screen 

Figure 3-4 


III*’ \ lij**/ UCIlMll /ufitill. I 

Target: sv^again:/ Sizes shov/n In Kbytes. 

All affected file systems on swagain:/are listed. 

To view software affecting a filesystem, open the filesysletn. 

File Systems 0 of 4 selecte 


Fi le Sys5f:cfn 
Mount Point 

Aval 1 nhl c-. 
Before 

Avai 1 nb 1 e 
After 

Capnci ty 
After 

Miirjt- 

Free 

A 

1 

9271 

8069 

S3% 

G 

/opt -> 

48523 

20 85 6 

65% 

G 

/usf —> 

78022 

38919 

84% 

0 

/vair —> 

6860 

3683 

83% 

O 


CJ 

1. The Disk Space Analysis gives you an estimateof avail able disk space 
vs. requirements for the new system. 

If disk space is a concern, you may want to look at graphics and 
related products especially for possible deletion. For example, in case 
you are running a Series 800 with a character terminal console, you 
may not want to update graphics products. 


NOTE If you are updating from an H P-VUE bundletoaCDE bundle, the /usr 

filesystem will undergo significant expansion. This expansion may 
exce^ the default file system size set by Cold Install for /usr. See 
"Adjusting File System Size", in Chapter 4, 'Troubleshooting Your 
I nstallation,"for information on resetting file system size. 


2. Ensure that the /var 'Available After" space is at least 20 MB. (The 
screen shown indicates only about 6 MB, which is insufficient and 
would require deletion of old log and tmp files in /var/adm and 
/var/tmp.) 
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NOTE 


Time Note 


After Logging in 


3. Close the Disk Space confirmation window to see the analysis 
wi ndow. 

4. When the disk analysis is satisfactory, choose OK on the Install 
Analysis screen to proceed with the update. 

5. A confirmation screen will appear, to which you can respond Yes or No 
as to whether you want to continue with the installation. 

Note that, up to this time, you can "back out" of any action by clicking on 

Cancel in order to return to previous screens, for example, in order to 

adjust the selection of filesets being updated. 

6. You will see a second confirmation screen warning you that a new 
kernel will be loaded (in case you are updating H P-UX or a 
kernel-related patch bundle), and this will necessitate a reboot. 
Respond Yes, if you wish to go ahead. 

7. You will see an install status screen which monitors the current 
progress of the installation, including the time remaining. 

8. I f you want to keep track of the progress of messages and scri pts 
being run during the load, you can keep a logfile window open during 
the process. Do this by clicking on the Logfile button, on the status 
screen. 

• A typical HP-UX update, if done from a network server, will require 
one to two hours. Systems with 16 M B of memory wi 11 requi re 
considerably longer. 

• At the end of an H P-UX update, you will see a confirmation message 
and reboot warning (with about 30 seconds delay until shut down). 

• As the system reboots for the first ti me, configure scri pts run for the 
new filesets so you can expect a first boot time of several minutes. 
Subsequent reboot processes will not take as long. 

1. The login screen appears after the system has rebooted. Log in at this 
time. 

2. Check the foil owing I ogfi I es for any messages, including warnings, 
rel ati ng to the update: 

/var/adm/sw/swinstall.log 
/var/adm/sw/swagent.log 
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Updating a Patched 
System 


If You are Updating 
fromHP-VUEto CDE 
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For an OS update, you will also need to repeat the update steps with the 
appropriate bundle on the HP-UX Extension Software which came with 
your H P-UX media. This provides core-related patches for the current 
version of HP-UX. (See"Using HP-UX Extension Software", in this 
chapter, and the patch descriptions on the disc.) The system will 
automatically reboot after updating with this bundle. 

If you are updating the OS of a previously-patched HP-UX 10.x system, 
you will need to remove the old patches after installing. The cleanup 
tool is available to accomplish this selectively by examining the I PD and 
removing references to old patches. You can get cleanup via the patch 
PHCO_12140, availablefrom your HP support service. 

The H P-UX 10.20 CDE filesets do not contain updated versions of 
SharedPrint or HP VUE files. Therefore, when updating from HP VUE to 
CDE, the old versions of SharedPrint or VUE remain on the system. Asa 
result, you will see SharedPrint and VUE errors appearing in the 

swagent. log, and the swverify . log (if swverify has been run). 

These messages can beignored, as no functional problems areimplied. 
The foil owing filesets will produce these failed verify error message: 

SharedPrint.SHP-ENG-A-MAN 
SharedPrint.SHPRNT-CLI 
SharedPrint.SHPRNT-PCL 
SharedPrint.SHPRNT-SRV 

VUE.VUE-RUN 
VUE.VUE-HELP-INFO 
VUE.VUE-MAN 
VUE.VUE-RUN-AUX 

(Non-English systems will display the localized fileset names.) 

I n addition, note that your 10.01 and 10.10 files will work on H P-UX 
10.20, as binary compatibility between versions has been maintained. 
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Updating Non-Interactively from Media or 
Network 

For a generic update where no "customizing" is required, you will be 
using theswinstaii tool non-interactively, with a general instruction to 
"match what the target has" in order to load the updated versions of the 
samefilesets as you have on your current system. Note that you cannot 
update non-i nteractively from a multiple-media set. 

1. If you are using CD-ROM, ensure that the drive is turned on and that 
the medium is inserted in the drive. 

2. At a shell prompt, enter the foil owing: 

swinstall -x match_target=true -x autoreboot=true -s d0/ice_file 

Enter 

Specify the device_filefor your, CD-ROM drive, or network source. For 
example 

/SD_CDROM/Clt2d0 

or similar, for a CD-ROM 

or 

hostname: / depot path 
for network sources 

You will see warning messages in case filesets are found on the target 
system that are not on the source. 


NOTE You will alsoneedtorepeattheabovesteps with the appropriate bundle 

on theFIP-UX Extension Software. (See "Using FIP-UX Extension 
Software" and the patch descriptions on the disc.) The system will 
automatically reboot after updating with this bundle. 


Using HP-UX Extension Software 

For core-specific patches to FI P-UX 10.20, you will have an Extension 
Software CD-ROM containing Series 700 and Series 800 10.20 Patch 
Bundles. (If your system came with I nstant Ignition (pre-loaded) FI P-UX, 
your Extension Software is on the disk and will load automatically.) I n 
the event that you need to apply core-specific patches to your system, you 
will use the same SD update process with theExtension Software as for 
other types of 10.x software. 
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The Extension Software CD depot directory looks similar to the 
following. It will contain critical patches relating to the 10.20 core 
software only: 


READMEFIRST 


/SD_CDROM. 


READMES_i PB_07_700_1020.1 j 

|PB_07_800_1020.1j 

lO.X_|s700_10.20 

s800_10.20 


The 10.20 bundles are contained in SD depots (the update format used 
for H P-UX 10.x). I n addition, these will be identified for Series 800 
(s800_io. 20) or Series 700 (s700_io .20). 


• You should first identify the bundle which is appropriate to your 
system(s). 

• Specific documentation for each bundle (in Laser] et/PCL format) is 
kept in the /SD_CDROM/READMES directory. Before installing from a 
Patch Bundle, you can print the appropriate Readmefilefor that 
bundle, using the ip -oraw command. 

• Use the install procedure given in this chapter "Updating HP-UX 
Software" to install the patch bundle, 

• Use swinstaii or swciuster, as appropriate. 

• Set Source Depot Path to /sd_cdrom/io .x/s700_io .20 or 
/SD_CDROM/10.X/s800_10.2 0. 

• From the Actions menu, select Match What Target Has. 

• Perform installation analysis (Actions ^ I nstall (analysis), if 
needed. 

• If there are no errors, proceed with the installation at the prompt 
message. 

• To get general information about patching your system, seethe 
following files in /usr/share/doc: 

Patch_pgm.txt 
sw_patches.txt 
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Adding Additional Functionality 

In case you need to add more bundles for the new functionality of HP-UX 
10.20, such asj FS or NFSD filesets, use the "Match What Target Has" 
option described in this chapter, and then select additional bundles 
which you have purchased. 

If you need further details, seethe manual Managing H P-UX Software 
with SD-UX. 

Networking Products on Additional Media 

I f you are usi ng certai n network! ng products or other I ndependent 
Software Units (I S Us) which are not present on the core H P-UX CD, then 
you may need to fol low modified update procedures. Some of the 
networking products affected include FDDI, Token-Ring and lOOVG 
AnyLan, which are provided on the H P Applications CD-ROM. 

Since optional networking products areshipped on separate media from 
the CORE H P-UX, their drivers are removed from the kernel during the 
update process. This means that if you update using the core medium or 
a depot made from it, the optional network! ng wi 11 not be avail able after 
reboot. 

If the networking which was removed provides access to the remote SD 
depot or cd-rom drive, then, after reboot, any swinstall of applications, 
including networking will need to be performed from a local CD-ROM 
drive. 

An alternative is to use swcopy to create a combined core and 
Applications depot and use that depot as your swinstaii source. 
Since a combined depot contains the new revisions of the networking 
products, their drivers will be reinstalled before reboot and so the 
networking they provide will be available after reboot. 

I f you have a custom update tape provided as part of you H P software 
support contract, then it is normally already combined and you do not 
need to create a combined depot, as long as the update tape, or any depot 
made from it, contains the H P-UX core software and the optional 
networking software which you need. 
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Installing the Optional OnlineJ FS Product 

HP Online] FS is the advanced optional bundlefortheVxFS FileSystem. 
You can use the capabilities of OnlineJ FS to perform certain key 
administrative tasks on mounted VxFS filesystems. Because you can 
perform these tasks on mounted file systems, users on the system can 
continue to perform their work uninterrupted. 

These tasks include: 

• Defragmenting a file system to regain performance. 

• Resizing a file system. 

• Creating a snapshot file system for backup purposes. 

You can install it with swinstaii in the following order: 

1. I nstall thej ournalFS product, if it is not already installed. 

2. Install two HP Online) FS bundle fi I esets. 

(AdvJournalFS.VXFS-ADV-KRN and 
AdvJournalFS . VXFS-ADV-RUN). 

During the install, swinstaii will edit the /stand/system file, rebuild 
the kernel, and reboot the system to bring the new kernel libraries into 
memory. 

For more information about installing and using VxFS and HP 
OnlineJ FS, seethe manual H P-UX System Administration Tasks, 
Chapter 4. 
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Trou bl eshooti ng You r 
Installation 
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Network Install 

The following are some items to check if you have problems during the 

install process: 

I f your system fai I s to fi nd a boot server, check the fol Iowi ng: 

1. M ake sure you are usi ng the correct boot command (you must use the 
"install" keyword for newer Workstation (Series 700) systems). For 
older systems, you may need to enter the boot command two or three 
times. 

2. Check for error messages on the server, logged to the file 

/var/adm/syslog/syslog. log. Look for instl_bootd messages. 

3. Makesurethat the /etc/insti_boottab file contains at least one 
IP address that is valid for your network. 

4. Make sure the server for the install kernel is on the same subnet as 
the system you are trying to boot. (The install server itself does not 
need to be on the same subnet). 

5. If the file /var/adm/inetd. sec exists and has a tftp entry, make 
sure it allows access to the addresses listed in /etc/insti_bootab. 

6. If your system has multiple Ian cards, make sure /dev/ianO you 
pick the one connected to the proper network. 

7. Check to see that /var/adm/sysiog/sysiog. log has an entry 
such as the fol I owing: 

inetd[306]: instl_boots/udp: Unknown service 

If there is also an entry in your local /etc/services for 
insti_boot s, check to See if your system is set up to use NIS. I f so, it 
may be that the version of /etc/services supplied by your NIS 
server needs to have the entries for insti_boots and insti_bootc 
added. 
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Media Install 

If your installation from the media fails, check the following: 

1. If you are using a CD-ROM as a depot for updating or installing 
software, ensure that the CD-ROM is mounted, using the mount 
command, before you attempt to use it as a source. 

2. Ensure that connections to drive(s) and I/O cards are secure. Remove 
and replace cables or cards if a loose connection is suspected. You 
would want to do this, for example, if the system is unable to contact 
the drive. 

3. I f you forget to change source tapes, you may see the fol low! ng error: 

"loopback:/dev/rmt/Om": An I/O error occurred while performin 
g this task. 

The swinstuii uti I ity dispiays this message when it reads an i nstal I 
tape that you have inadvertently left in the drive, and which does not 
have any SD information on it. 

Adjusting File System Size 

If therequired file-system size for the bundleyou install exceeds that file 
system limit set by your disk installation, you will get an error condition 
during install. You can use ivextend and extendfs in this situation to 
create a larger file system. 

You might have a problem updating your system(s) if the /usr volume is 
too small. The previous default size was 300 M B, and depending on 
which bundleyou are updating, you might require more. 

If you try an update, swinstaii will determine how much disk space is 
required. If there isn't sufficient space, swinstaii will report an error 
like this: 

ERROR; The used disk space on filesystem "/usr" is estimated 
to increase by 57977 Kbytes. 

This operation will exceed the minimum free space for this 
volume. You should free up at least 10854 Kbytes to avoid 
installing beyond this threshold of available 
user disk space. 

I n this example, you would need to increase the file system size limit of 
/usr by 10 MB, which actually needs to be rounded up to 12 M B. 
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Here are the steps required for increasing the size limit of /usr: 

1. Determine if any space is available by entering the following: 

/sbin/vgdisplay 

You should seea display I ike the following: 


- Volume groups - 
VG Name 

/dev/vgOO 

VG Write Access 

read/write 

VG Status 

available 

Max LV 

255 

Cur LV 

8 

Open LV 

8 

Max PV 

16 

Cur PV 

1 

Act PV 

1 

Max PE per PV 

2000 

VGDA 

2 

PE Size (Mbytes) 

4 

Total PE 

249 

Alloc PE 

170 

Free PE 

79 

Total PVG 

0 


The "Free PE" indicates the number of 4 MB extents available, in this 
case this is 79 (equivalent to 316 MB). 

2. Enter the following: 

/sbin/shutdown 

Change to single user state. This will allow /usr to be unmounted. 

3. Enter the following: 

/sbin/mount 

You will see a display similar to the following: 

on /dev/vgO0/lvoll defaults on Sat Jan 28 23:19:19 1995 
/usr on /dev/vgO0/lvol7 defaults on Sat Jan 28 23:19:28 1995 

4. Determine which logical volume maps to/usr. This should be 

/dev/vg00/ivoi7 by default. 

5. Extend the size of the logical volume by entering the following: 

/sbin/lvextend -L $Old SpaC6 + nav SpaC6 /dev/vg00/lvol7 

This extends the size of the logical volume. 

For example, 

/sbin/lvextend -L 332 /dev/vg00/lvol7 

This will make this volume 332 MB. 
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6. Executethefollowingcommand: 

/sbin/umount /usr 

This is required for the next step, since extendfs can only work on 
unmounted volumes. 

7. Executethefollowing command: 

/sbin/extendfs /dev/vg00/rlvol7 

This extends the file system size to the logical volume size. 

8. Finally, executethefollowing commands: 

/sbin/mount /usr 
exit 

9. Go back tothe regular init state (3 or 4). 
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Large System 

If your arerunninga system with a largenumba of filesystems, note the 
following possible problem areas: 

1. On a large system such as a T500 with a very large number of disk 
drives (such as 50 or more), you may see messages such as the 
following, during the system analysis phase of cold install. 

Out of inode- can't link or find disk 

or 

Write failed, file system is full, 
or 

File system full. 

2. To reduce the likelihood of this problem occuring, before you do the 
installation you should turn off any disks you don't plan to use for the 
installation process and start over. 

3. After the system is cold-installed, you may wish to add back all the 
file systems that existed under the previous installation, either 
manually or using SAM. However, for a large number of filesystems 
(for example, over a hundred), some tables in the kernel may be too 
small to allow correct booting. This is because the newly-installed 
kernel contains default values for kernel tables sizes, and does not 
allow for special configurations made to the kernel installed 
previously. 

For example, thefirst boot after adding the file systems may result in 
error messages displayed to the console, such as the following: 

inode: table is full 

proc: table is full 

file: table is full 

Additionally, the boot may fail in various ways. For example, you may 
be ha veto do file system repair manually. 

• If this is not possible, the kernel may need to be re-configured 
before booti ng. The fol Iowi ng setti ngs should al Iow the kernel to be 
booted, but may not be optimal for the system: 

- ninode = 2048 (default is 476) 

- nproc = 1024 (default is 276) 

- nfile = 2048 (default is 790) 

• Alternatively, you may wish to re-configure the kernel inoneofthe 
following ways: 
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• By raising maxusers toa large value, such as 200 . 

• By selecting an appropriate bundle of SAM-tuned parameters 
from the SAM Kernel Configuration Actions menu. 

You should determine the correct configuration for your system. 

Note that this problem does not appear to affect the Upgrade process 
(updati ng from H P-U X 9.0x), si nee duri ng U pgrade, the new kernel 
parameters are derived from the previous kernel. 
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A Sample Configuration File 


The H P-UX cold-install process is driven by information stored in 
configuration files. There arethree primary locations where a network 
cold-install can find configuration file information on the server: 

1. I n the area accessed by the insti_adm (iM) tool. This information is 
immediately available to clients when they boot. The data stored in 
this location is limited to 8 KB. 

2. I n the file /usr/lib/sw/hpux . in St all/con fig. local. This 
information is available after the client enables networking. It does 
not have a fixed size limit. 

3. The file /usr/iib/sw/hpux . instaii/conf ig is wherethe default 
configuration information that comes with HP-UX is stored. 

Please see the i nstl_adm(lM) and i nstl_adm(4) manual pages for more 
details. 

The following set of examples may be useful when saved toa file, and 
then installed using the insti_adm -f filecommand: 

# Set the default netmask and gateway for all clients 

# (can also be set using instl_adm with -m & -g options) 

netmask = "255.255.248.0" 
gateway = "15.1.48.1" 

# Set the default install/tftp server: 

server = "15.1.54.114" 

# Set the default hostname, IP address and disk to use as the 

# root disk for the system matching the lan-link address shown: 

LLA_ADDR == "08000941C3BD" { 

system_name = "swig" 
ip_addr = "15.1.54.104" 
best = disk[52.2.0] 

} 


# Specify the networking information for another system, and also 
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# specify that the installation should be done non-interactively: 

LLA_ADDR == "08000978BBBB" { 

system_name = "swbba" 
ip_addr = "15.1.54.138" 

RUN_UI = FALSE 

# Give users 10 seconds to respond to warnings before 

# continuing with the automatic installation: 

env_vars +="INST_ALLOW_WARNINGS=10" 

} 

This examplecan be added to the/ usr/ lib/ sw/ hpux.install/ configlocal 
file. It does not have the same 8 KB restriction as the examples above. 

# Specify the possible SD-UX servers and depot locations. This example 

# also shows how to use the "use model" variables to provide a 

# selector that the user will see during the install: 

radio_sel { 

[ "Depot Server:.*" ] 

} 

"Depot Server:Jupiter" { 

sd_depot_dir = "/depot/hp-ux_700" 
sd_server = "15.1.54.112" # Jupiter 

} 

"Depot Server:Orion (CD-ROM)" { 

sd_depot_dir = "/SD_CDROM" #depot on CD-ROM 
sd_server = "15.1.54.20" # Orion 

} 

# For systems matching these lan-link addresses, specify that 

# they execute the shown post_config_cmd. This particular 

# post_config_cmd will copy over some extra files and some files 

# that are specific for each system using tar(l) and remsh(l). 

# The result depends on what is copied over, but if the files 

# consist of the /etc/rc.config.d/netconf and other configuration 

# files, the system will boot up without the need for further 

# manual configuration. 

LLA_ADDR == "08000978BBBB" | LLA_ADDR == "08000941C3BD" 

{ 

post_config_cmd=" 
cd /; 

remsh 15.1.54.114 \"(tar -cf - -C /sdux/systemenvs/generic . \ 
-C /sdux/systemenvs/'hostname' .)\" I tar -xvf 

swinstall -s 15.1.54.112:/languages/depot XDB; 

# If a RUN_ME file was copied over, run it: 

[ -X /RUN_ME ] & /RUN_ME" 

} 


# Define a whole-system level use model for a system, and 

# make it the default for that system (note that this is 

# the same system that was configured to do an automatic 

# install in the previous section). 

init "SYS:Custom config for swbba" = (LLA_ADDR == "08000978BBBB") 
"SYS:Custom config for swbba" { 

init "Software Selection:Runtime Environment" = true 

init "Software Language:Japanese" = true 

init "Disk Layout:Logical Volume Manager" = true 
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# Load the ASX bundle from a different depot during the 

# post config phase (in addition to other post_config_cmd). 

post_config_cmd += " 

swinstall -s 15.1.54.112 :/asx B3782CA_ABJ" 

# For LVM configurations, adjust the volume size 

# for /var and create a /extra volume: 

"Disk Layout:Logical Volume Manager" { 
volume_group "vgOO" 

{ 

logical_volume { 

mount_point = "/var" 
usage = HFS 
size = 100Mb 
nbpi = 2048 

"File system file name length:Short" { 
file_length=short 

} 

} 

logical_volume { 

mount_point = "/extra" 
usage = HFS 
size = remaining 

} 


} 

# Define a new software selection that will appear along with 

# with other software selections. Note that the software language 

# specification will be ignored when this is selected. 

"Software Selection:Software config for our office." 

help_text "This is a custom software selection that selects only what 
our office needs. (Desktop, ANSI-C, and our own software)" 

"Software Selection:Software config for our office." { 
sd_software_list = " 

Product_Name 

Product_Number 

OurSW 

II 


When a system is installed, the configuration that was selected for that 
system is stored in the/ usr/ lib/ sw/ hpux.install/ configlocal file. A 
system that is configured as a network cold-install server will provide its 
own configuration to its clients as an option from which the the user can 
select. 

It is also possible to concatenate another system's configlocal filetothat 
of the server's in order to have multiple configurations available to 
clients. Alternatively, the configlocal file may be hand-crafted (as shown 
in the previous example) to make slight modifications to the default 
configuration. 
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rep systeml:/usr/lib/sw/hpux.install/config.local /tmp/cfgl 
cat /tmp/cfgl >> /usr/lib/sw/hpux.install/config.local 

rep system2:/usr/lib/sw/hpux.install/config.local /tmp/cfg2 
cat /tmp/cfg2 >> /usr/lib/sw/hpux.install/config.local 

Then run the insti_adm command to test the configuration syntax 
before proceedi ng: 

instl_adm -T 
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B 

Configuring for a DHCP Server 

Appendix Contents 

The H P-UX 10.20 version of the HPUX 1 nstall and system boot tools 
supports retrieving network information via the Dynamic Host 
Configuration Protocol (DHCP). This appendix gives the details of 
setting up DHCP. 

• Using DHCP Services: Overview. 

• Setting Up a DHCP Server. 

• Details on the DHCP Services. 

• Enabling DHCP on a System Not 1 nitially Configured with DHCP. 

• Background 1 nformation on DHCP Design. 

• For More 1 nformation (man pages and URL). 
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Using DHCP Services: Overview 

DHCP provides the following features: 

• Allows for dynamically allocating IP addresses and hostnames. 

• Automatically supplies most of the networking defaults that are 
requested during a system installation or first time boot. 

• Provides for on-going IP address maintenance via a concept of an "I P 
address lease". Having a lease on an IP address means that if the 
system "goes away" for a specified period of time without renewing 
the lease, then that IP address can be given to a different system that 
request a new IP address lease. 

• Assists in reestablishing valid network parameters when a system 
has been moved from one DHCP-managed network to another. 

The environment where DHCP works best is where the foil owing 

conditions and restrictions exist: 

• When a range of currently unused IP addresses can be allocated for 
use during new system bring-up. 

• When the IP address-to-hostname mapping can be made ahead of 
time (before the system to use it is installed). And this mapping can 
be configured in the name services database before installing a 
system. 

• When the IP address and hostname that get assigned to a system are 
not i mportant. A system wi 11 keep the same IP address and hostname 
for as long as it renews the lease. However the original assignment is 
arbitrary. 

• When the person i nstal I i ng the systems does not desi re to choose a 
hostname for the system, but rather accepts the one already 
registered for the IP address supplied by DHCP. This will ensure that 
the system will be recognized immediately by its hostname. 

• When existing systems that did not use DHCP before will continue 
not to use it. Or, if they did, they would be willing to accept an 
arbitrary hostname and IP address. This is the same as a with a new 
system. There currently is no tool aval I able for pre-loading the DHCP 
database with existing IP addresses and identifying the systems they 
belong to. A tool to do this may be available in a future release. 
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Setting Up a DHCP Server 

Once you have decided that using DHCP will provide a benefit, you will 
need to follow the steps below to set upa DHCP server. Note that only 
one DHCP server per network subnet is required. On the server system: 

1. Allocate a set of currently unused IP addresses (preferably a 
contiguous block of addresses). For example: 

15.1.48.50 - 15.1.48.80 

2. Pre-assign and register hostnames tothe IP address allocated above. 
Using the -h option tothedhcptools(lM) command may be useful. 

For example, the following line: 

dhcptools -h fip=15.1.48.50 no=30 sm=255.255.255.0 hn=devlab## 

This command will create a file /tmp/dhcphosts that can be 
incorporated into your /etc/hosts or dns/nis database. 

3. Designate a system to act as the DHCP server for your network. This 
should be a system that is "always" availableto it's clients. 

4. UsetheSAM application to configure the DHCP services on this 
server. To do this: 

a. Start the interactive SAM application by typing sam. (Note, you 
may need to set your display variable to use the graphical 
version) 

b. Doubleclick on the icon Networking and Communications. 

c. Doubleclick on the icon Bootable Devices. 

d. Doubleclick on the icon DHCP DeviceGroups Booting From this 
Server. 

You should now see a screen that lists any DHCP groups already 
defined (there may not be any if DHCP is not already configured). 

e. To add the new group of IP addresses which you allocated in Step 
1, click on the Action menu item and choose Add DHCP Group. 

This should bring up a form with parameters to fill in. 

f. Now you will need to fill in the information on this screen. Some 
information may require additional research if you are not 
familiar with the terms or with your network. 
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Group 

Name: 

This can be any name that isn't already defined 
as a DHCP group. For example: groupi 

Subnet 

Address: 

This is the portion of an 1P address that is not 
masked off by the subnet mask (see below). If 
you don't want to figure this out, then just enter 
one of the IP addresses in the range you picked 
along with the correct subnet mask and SAM 
will take care of the calculation. For example: 
15.1.48.50 

Subnet 

Mask: 

This depends on the "class" of your network, and 
basically determines how an 1P address is 
separated into a network number and a host 
specific number. Press FI in this field for more 
information. For example: 255.255.255.0 

Subnet 

Address 

Pool: 

Press this button to select the range of 1P 
addresses that you allocated in Step 1. A new 
screen will be displayed where you can enter the 
Start and E nd address. 1 f there are addresses 
within the range that you picked that you do not 
want allocated via DHCP, you can use the 
Reserved Addresses button to specify those (or 
ranges of them). 

Allow Any 
Device 

Class: 

The SAM default is to allow any type of DHCP 
device to use the group of 1P address you are 
configuring. This may be undesirable if you use a 
different method (or a different DHCP server or 
group) for managing systems such as PCs 
running Win95™ or NT™. 
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Automatic 
Allocation 
to Bootp 
Clients: 

1 f you want this range of addresses to be used 
only by H P-UX systems, then unselect this 
button, and enter the text: 

"HewlettPackard. HP-UX" in the text field 
provided. 

Leave this option disabled. Enabling it will 
cause problems for bootp devices such as 
printers and terminals which rely only on their 
preconfigured server to respond to their boot 
request. 

Accept 

New 

Clients: 

Leave this option enabled. 

Address 

Lease 

Time: 

The lease time should be set sufficiently long so 
that if a client system is temporarily out of 
service (off) for a time, its lease will not expire 
too soon. 

1 nfinite leases will never expire and disable the 

1 P-address reclamation features of DHCP. For 
example: 2 weeks. 

Boot file 

name: 

You can leave this field blank. 

Additional 

Params.: 

There are many parameters that can be specified 
in this screen for such things as the default 
routers, time server, DNS server, and Nl S 
domain. You can specify as much or as little as 
you like in this area. 

Only the more basic parameters are actually 
used by installation and boot configuration tools. 

Callback 

Routines: 

None is necessary. 
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g. Once the parameters are all filled in, then pressOK on theAdd 
DHCP Group screen. SAM will then make the modifications to the 

/etc/dhcptab file. 

h. Youwill now want tousetheAction menu to Enable boot Server (if 
it is not already enabled). 

5. Now, new systems that are installed with HP-UX 10.20 (or newer) or 
booted with a pre-installed 10.20 (or newer) version of H P-UX should 
contact this server to get an IP address lease and other network 
information provided by the server. 

• When doing a cold install of the HP-UX Operating system (version 
10.20 or newer): 

The installation tools will broadcast out on the network for any 
available DHCP servers. The first server to respond will be chosen to 
provide the default network information that the user is presented 
with. 

I n the network parameters screen during a Cold I nstall, you seethe 
question: "Is this networking information only temporary?". The 
"yes" or "no" answer to this implies the following: 

• "no": Answering "no" (the default) means that if the IP address 
and hostname were leased from an DHCP server, then that lease 
will be retained after the install is done, so that the first boot of 
the system will attempt to renew the same lease. 

• "yes": Answering "yes" implies that the IP address and hostname 
lease should be returned tothe server after the installation is 
complete. I n this case, the first system boot will try to get a new 
lease. This is most useful when the system is being installed on a 
network that is different from its final destination. 

(This answer tothe question can also be set in the configuration 
file with instl_adm(lM) using the keyword 

is_network_inf o_temporary). 

When automating system installations, the DHCP services allows 
systems to get networking information without the need to make a 
mapping in the H PUX-I nstall configuration files (See instl_adm(lm) 
and instl_adm(4)). 

• When a system boots for the first time (either after a Cold I nstall, or 
the first boot of a pre-loaded (I nstant Ignition) system): 


98 


Appendix B 



Configuring fora DHCP Server 

Setting Up a DHCP Server 


Enabling DHCP on a 
System Not Initially 
Configured with DHCP 


NOTE 


The auto_parms tcxol, that lets you configure the system identity and 
basic configuration parameters, will invoke the dhcpciient, which 
will broadcast out to find a DHCP server. The server, in turn, provides 
a default set of networking parameters. 

I n both cold install and a first boot of a pre-loaded system, if the user 
chooses not to use the IP address given by the DHCP server, the tool 
will inform the DHCP server that it can release the lease on it and 
give it to someone else. 

• At each system boot: 

If a client system was initially set up using an IP address that was 
leased by a DHCP server, that client will check to ensure that the 
lease is still valid at each boot. I n addition, the system will start a 
daemon process (dhcpciient -m) that will maintain and renew that 
lease while the system is running. 

If a system cannot contact the DHCP server from which it originally 
got the IP address lease, it will try to contact other DHCP servers in 
order to determine if it has been moved to a different network. If this 
is the case, the system will write a message to the auto_parms log 
file (/etc/auto_parms. log) indicating that it has detected a move 
to a new subnet and that it is attempting to request a new lease. If 
the new lease request is successful, new networking configuration 
values supplied by the DHCP server will automatically be applied. 

If a system has been set up without using DHCP, but you would like to 

start using it, the foil owing steps may betaken. 


The system's hostname and IP address may change based on what the 
DHCP server assigns to it the first time it boots. 

There are two methods for enabling DHCP on a system that is not 
currently using it: 

1. The first method is to use SAM. 

a. As root, run sam. 

b. Doubleclick Networking and Communications. 

c. Doubleclick Network InterfaceCards. 

d. Highlight the card you wish to enable DHCP on, go to the Actions 
pull-down menu and select Configure. 
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e. Singleclick the Enable DHCP button. 


NOTE If EnableDHCP appears grayed-out, you will need to use the alternate 

method for enabling DHCP described below. 


f. Singleclick OK and exit SAM. 

Your system will now begin using DHCP after the next reboot. Please 
note that all of the current networking parameters will be overridden 
with new values supplied by the DHCP server. I f for some reason the 
system cannot contact a DH CP server duri ng the next reboot, it wi 11 
continuetouseitscurrent networking parameters. 

If you suspect that your system had problem contacting the DHCP 
server, you can examine the auto_parms log file 
(/etc/auto_parms. log) to determine if the lease request was 
successful. 

2. The second method for enabling DHCP over a particular network 
interface is use a text editor (such as vi or emacs) to edit the 
/etc/rc. config. d/netconf file. I n the header of this file, you will 
find some brief instructions regarding a variable named 
DHCP_ENABLE. This Variable is tied by an index number to an 
individual network interface. For example, in the following block: 

INTERFACE_NAME[0]=lanO 
IP_ADDRESS[0]=15.1.50.76 
SUBNET_MASK[0]=255.255.248.0 
BROADCAST_ADDRESS[0]="" 

DHCP_ENABLE[0]=1 

Here, the variables are instructing the system to use the lanO 
interface when attempting to contact a DHCP server. Similarly, if the 
lease request is successful, the above ip_address variable would be 
updated to reflect the new value supplied by the DHCP server. 

If the DHCP_ENABLE Variable was set to o or if the variable did not 
exist, no DHCP operations would be attempted over the 
corresponding network interface. 

As noted in the first method of enabling DHCP, if the variable 
DHCP_ENABLE does not exIst for a particular interface, the SAM tool 
will display a grayed out DHCP enable button. 

In this case, you will need to add the variable definition to a specific 
interface variable block. As an example, you would need to add 
DHCP_ENABLE [2] =1 tothefollowlng Interface Variable block in order 
to enable DHCP on theiani interface: 
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INTERFACE_NAME[2]=lanl 
IP_ADDRESS[2]=15.1.50.89 
SUBNET_MASK[2]=255.255.248.0 
BROADCAST_ADDRESS[2]="" 

The contents of /etc/rc. conf ig. d/netconf for this definition 
block should now look I ike the following: 

INTERFACE_NAME[2]=lanl 
IP_ADDRESS[2]=15.1.50.89 
SUBNET_MASK[2]=255.255.248.0 
BROADCAST_ADDRESS[2]="" 

DHCP_ENABLE[2]=1 

Correspondingly, you could disable DHCP over a particular interface 
by setting the variableto "0". 

Again, as in the first method, the system will only begin using DHCP 
after the next reboot. 

The DHCP protocol is implemented as extensions to the BOOTP 
protocol, and in fact the HP-UX DHCP server daemon and the BOOTP 
daemon are the same (bootpd(lM)). This daemon reads two configuration 
files: /etc/bootptab and /etc/dhcptab. 

The mapping of systems to IP addresses and lease time information is 
kept in the DHCP database file /etc/dhcpdb. Some amount of 
management of this database is provided by the dhcptooIsflM) 
command. 

On the client side, a command called /usr/ibin/dhcpciient is used 
to contact the server to get an IP address lease. This command has the 
ability to broadcast out onto the network prior to the network interface 
being enabled. 

The dhcpciient also serves as a daemon process that sleeps until the 
time that it needs to renew the IP address lease, at which time it will 
re-contact the server where it got the original lease in order to extend it. 

The dhcpciient command is not intended to be run by users directly, 
and is called by other tools during system bootup and installation. 
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For More Information Refer to the auto_parms(lM) man page and the dhcpdb2conf(lM) man 
page for more information regarding the networking parameters which 
DHCP can suppiy. 

More information on DHCP in generai can be found in thefoiiowing 
iocations: 

• Man pages: 

bootpd (Im) 
dhcptools(iM) 
auto_parms(iM) 
dhcpdb2conf (iM) 

• The Woridwide Web: 

http://web.syr.edu/~ jmwobus/comfaqs/dhcp.faq.html 
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